Set Up MCP
Open TelefonX Settings … MCP. The Model Context Protocol (MCP) lets compatible assistants read TelefonX data and perform actions. See Use TelefonX with an AI Assistant for everyday use.
Requirements
Section titled “Requirements”- An assistant on this Mac that supports MCP over Streamable HTTP with a custom Authorization header.
- TelefonX must be running. Its main window can be closed or minimized.
MCP is free. Pro features still require TelefonX Pro. The server is accessible only on this Mac at 127.0.0.1.
Enable the local server
Section titled “Enable the local server”- Turn on Enable MCP. MCP is off on a new installation.
- Check the displayed Address. The default port is
53127, and the default address ishttp://127.0.0.1:53127/mcp. - If you need a different Port, enter a value from
1024to65535. PressReturnor leave the field to apply it.
The status dot shows whether the server is active. After changing the port, update the server address in any assistants already connected.
Add and connect a client
Section titled “Add and connect a client”- Under Authorized Clients, click Add Client ….
- Enter a Client Name and select the required permissions under Access.
- Click Save. The Connect Your Assistant dialog shows the Server Address and Access Key.
- Use Copy Server Address and Copy Access Key to transfer both values to your assistant’s MCP connection. Select Streamable HTTP and set the header to
Authorization: Bearer <access key>.
Copy the access key before closing the dialog. It is masked and cannot be retrieved later. Keep it secure.
Set up the connection in ChatGPT
Section titled “Set up the connection in ChatGPT”The official OpenAI guide to connecting MCP servers in the ChatGPT desktop app explains how to add a custom server. For TelefonX, use Streamable HTTP with the server address shown above and the header Authorization: Bearer <access key>.
Set up the connection in Claude Desktop
Section titled “Set up the connection in Claude Desktop”For Claude Desktop, you can use a local adapter such as mcp-remote. It connects Claude’s local MCP integration to the TelefonX HTTP server. The Claude guide to local MCP servers explains how to manage local connections.
Add the adapter to Claude’s local MCP configuration. Use the TelefonX server address and pass the access key in the Authorization header. See Custom Headers in the mcp-remote guide for an example. Claude’s cloud connectors cannot reach the local address 127.0.0.1.
Manage access permissions
Section titled “Manage access permissions”New clients start without access. Use Edit … to change a client’s name and permissions.
| Permission | Effect |
|---|---|
| Read | Reads TelefonX data, including Apple Contacts and saved transcripts and summaries. |
| Write | Manages data and controls calls, recordings, and settings. |
Shared data is passed to the assistant and may be processed by its provider. With write access, the assistant performs actions directly within its granted permissions. These include calls, deletions, and changes to call routing.
End access
Section titled “End access”Remove Client … immediately revokes the assistant’s access after confirmation. If an access key is lost or needs replacing, remove the client and create it again.
Turn off Enable MCP to stop the local server. Requests waiting for local input are canceled. This does not end an ongoing call.