TrueConf Server MCP

Manage TrueConf Server conferences, recordings, and invitations from any MCP client, including LM Studio, Cursor, Claude Desktop, and others.

English / Русский

[!CAUTION] These instructions apply to TrueConf Server 5.5.3 and later. If you are running an earlier version, update your server.

Introduction

Model Context Protocol (MCP) is an open standard that allows large language models (LLMs) to invoke external tools through a unified protocol. Without MCP, every LLM client would require a separate TrueConf Server API integration. With MCP, a single server exposes all tools, and any compatible MCP client can immediately use them to create conferences, manage invitations, and access recordings.

TrueConf Server MCP is an intermediary between an LLM client and TrueConf Server. It provides 30 tools for working with conferences, recordings, invitations, participants, calendars, notifications, and translations.

Server capabilities

Quick start

1. Install the MCP server. → Step 1
2. Create an OAuth application on TrueConf Server. → Step 2
3. Start the MCP server. → Step 3
4. Sign in and obtain a token. → Step 4
5. Connect an MCP client such as LM Studio or Cursor. → Step 5
6. Verify the connection. → Step 6

Step 1 — Installation

pip install trueconf-server-mcp

[!TIP] If you have uv installed, you can run the server without installing it:

uvx run trueconf-server-mcp --server 10.0.0.1 --client-id ... --client-secret ...

Step 2 — Create an OAuth application

The MCP server requires the client_id and client_secret of an OAuth application configured on TrueConf Server.

1. Open the TrueConf Server control panel and go to Web → Security → OAuth 2.0. For details, see the documentation.

2. Create an application and specify the following redirect_uri:

   http://localhost:8080/auth/callback
   

   [!IMPORTANT] The redirect URI must equal MCP_BASE_URL followed by /auth/callback. If you use another host or port, update it accordingly. See MCP_BASE_URL.

3. Enable the scopes required by the tools:

   Scope	Description
   conferences:read	Read conferences, deep links, shared links, calendars, and translations
   conferences:write	Create, edit, delete, start, stop, join, invite, notify, and register conferences
   conferences.invitations:read	Read invitations
   conferences.invitations:write	Add, edit, and delete invitations
   conferences.participants:read	Read conference participants
   conferences.records:read	Read recordings
   conferences.records:write	Start, stop, and pause recordings
   conferences.restrictions:read	Calculate conference restrictions (calculate_conferences)

4. Copy the client_id and client_secret. You will need them in the next step.

Step 3 — Start the server

trueconf-server-mcp \
  --no-tls --port 8080 \
  --server 10.0.0.1 \
  --client-id <client_id> \
  --client-secret <client_secret>

Where:

• --server is the IP address or domain name of TrueConf Server.
• --client-id and --client-secret are the OAuth application credentials from step 2.
• --no-tls --port 8080 starts the server without TLS on port 8080 for initial setup and testing.

[!TIP] The --no-tls option transmits the bearer token without encryption. Use it only for initial setup and testing.

For production, start the server without --no-tls. A self-signed TLS certificate will be generated automatically, and the server will listen on port 443. If your LLM client does not trust self-signed certificates, you can either:

• configure your own certificate, such as a Let's Encrypt certificate;
• disable certificate validation in the client, as shown for LM Studio.

[!CAUTION] Ports 80 and 443 are privileged ports. To use them:

OS	Action
macOS	Binding to 0.0.0.0:80 or 0.0.0.0:443 works without root privileges
Linux	Run sudo setcap cap_net_bind_service+ep $(which trueconf-server-mcp) or start the server with sudo
Windows	Run the application as Administrator (UAC)

If you do not have the required permissions, use --port 8080 or another port above 1024.

Step 4 — Authentication

1. Open http://localhost:8080/ in your browser. Click Sign in to open the TrueConf Server authentication page.

   

2. Enter your TrueConf Server credentials and grant access.

3. After successful authentication, you will be redirected to /success, which displays your token and ready-to-use MCP client configurations.

   

4. Copy the token. You will need it to connect your MCP client.

[!NOTE] The token is valid for 24 hours by default. You can change this using --api-token-ttl. After the token expires, sign in again at http://localhost:8080/.

Step 5 — Connect an MCP client

Copy the configuration for your client from the /success page or create it manually. Example for LM Studio:

{
  "mcpServers": {
    "trueconf": {
      "url": "http://localhost:8080/mcp",
      "headers": {
        "Authorization": "Bearer <your_token>"
      }
    }
  }
}

Ready-to-use configurations for Cursor, Claude Desktop, OpenCode, and OpenWebUI are available in MCP clients.

Step 6 — Verify the connection

Open your LLM client and ask:

Show my scheduled conferences

The LLM will invoke the list_conferences tool and return your conference list from TrueConf Server.

Configuration

Configuration precedence

Settings are applied in the following order, from highest to lowest priority:

1. CLI options — --server, --port, --no-tls, etc.
2. Environment variables — TRUECONF_SERVER, TRUECONF_MCP_PORT, etc.
3. The .env file — loaded with python-dotenv
4. Defaults — built-in values

Options

Command-line help

trueconf-server-mcp --help

The .env file

Instead of passing configuration through CLI options, you can create a .env file in the working directory. See .env.example:

TRUECONF_SERVER=10.0.0.1
TRUECONF_CLIENT_ID=your_client_id
TRUECONF_SECRET=your_client_secret
TRUECONF_VERIFY_SSL=false
MCP_BASE_URL=http://localhost:8080
MCP_NO_TLS=true
TRUECONF_MCP_PORT=8080

trueconf-server-mcp

TLS for production

By default, when --no-tls is not specified, the server listens on https://0.0.0.0:443 using an automatically generated self-signed certificate. On macOS, the certificate is stored in ~/Library/Application Support/fastmcp/tls/ and reused across restarts.

Custom certificate

To use a trusted certificate, such as one issued by Let's Encrypt:

trueconf-server-mcp \
  --server 10.0.0.1 \
  --client-id <client_id> \
  --client-secret <client_secret> \
  --tls-cert /path/to/cert.pem \
  --tls-key /path/to/key.pem

[!IMPORTANT] --tls-cert and --tls-key must be specified together.

LM Studio with a self-signed certificate

LM Studio is based on Node.js and does not trust self-signed certificates. If the following error occurs while connecting:

TypeError: fetch failed: self-signed certificate

Start LM Studio with TLS validation disabled:

NODE_TLS_REJECT_UNAUTHORIZED=0 open "/Applications/LM Studio.app"

set NODE_TLS_REJECT_UNAUTHORIZED=0
start "" "C:\Program Files\LM Studio\LM Studio.exe"

NODE_TLS_REJECT_UNAUTHORIZED=0 lm-studio

[!WARNING] NODE_TLS_REJECT_UNAUTHORIZED=0 disables certificate verification for all HTTPS requests made by the LM Studio process. Use it only for local development. In production, configure a trusted certificate with --tls-cert and --tls-key.

MCP_BASE_URL

MCP_BASE_URL defines the URL MCP clients use to reach the server. It is included in OAuth metadata and must be externally reachable by your clients.

[!CAUTION] Do not use 127.0.0.1 in MCP_BASE_URL if the MCP client runs on another machine; it will not be able to reach the server.

MCP clients

The server is compatible with any MCP client that supports HTTP transport with bearer authentication. Ready-to-use configurations are available on the /success page after authentication.

LM Studio

{
  "mcpServers": {
    "trueconf": {
      "url": "http://localhost:8080/mcp",
      "headers": {
        "Authorization": "Bearer <your_token>"
      }
    }
  }
}

[!NOTE] LM Studio does not trust self-signed certificates. See TLS.

Cursor

{
  "mcpServers": {
    "trueconf": {
      "url": "http://localhost:8080/mcp",
      "headers": {
        "Authorization": "Bearer <your_token>"
      }
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "trueconf": {
      "type": "http",
      "url": "http://localhost:8080/mcp",
      "headers": {
        "Authorization": "Bearer <your_token>"
      }
    }
  }
}

OpenCode

{
  "mcp": {
    "servers": {
      "trueconf": {
        "url": "http://localhost:8080/mcp",
        "transport": "http",
        "headers": {
          "Authorization": "Bearer <your_token>"
        }
      }
    }
  }
}

OpenWebUI

URL:       http://localhost:8080/mcp
Header:    Authorization: Bearer <your_token>

Tool discovery modes

The --discovery-mode option controls how the MCP client sees the server tools:

trueconf-server-mcp --discovery-mode bm25 --server ... --client-id ... --client-secret ...

Troubleshooting

If the problem persists, contact TrueConf technical support.

Links

• TrueConf Server API documentation
• Model Context Protocol
• TrueConf technical support