Skip to content

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.

  • 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.

  1. Turn on Enable MCP. MCP is off on a new installation.
  2. Check the displayed Address. The default port is 53127, and the default address is http://127.0.0.1:53127/mcp.
  3. If you need a different Port, enter a value from 1024 to 65535. Press Return or 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.

  1. Under Authorized Clients, click Add Client ….
  2. Enter a Client Name and select the required permissions under Access.
  3. Click Save. The Connect Your Assistant dialog shows the Server Address and Access Key.
  4. 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.

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>.

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.

New clients start without access. Use Edit … to change a client’s name and permissions.

PermissionEffect
ReadReads TelefonX data, including Apple Contacts and saved transcripts and summaries.
WriteManages 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.

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.