Conectar un asistente

Una aplicación de IA en el mismo ordenador que la aplicación de escritorio inicia por sí misma el servidor MCP de Trusted Codes y habla con él por una tubería. No se abre nada hacia la red. Los asistentes en el navegador no pueden conectarse; Asistentes en el navegador explica por qué.

Una versión posterior de la aplicación de escritorio conectará Claude Desktop con un clic. Hasta entonces, los pasos de esta página usan el Terminal.

Antes de empezar

• Instala la aplicación de escritorio e inicia sesión una vez.
• En un Mac, la aplicación debe estar en la carpeta Aplicaciones. Una copia que se ejecuta desde la imagen de disco descargada o desde la carpeta Descargas escribe una ruta que deja de funcionar.
• En Windows y Linux, una versión posterior de la aplicación hará la conexión por ti. Los comandos de esta página son para el Mac.

Claude Desktop (Mac)

1. Cierra Claude Desktop por completo (⌘Q).

2. Abre el Terminal y ejecuta:

   "/Applications/Trusted Codes.app/Contents/MacOS/tcc-desktop" mcp configure claude-desktop

3. Vuelve a abrir Claude Desktop.

Cursor (Mac)

1. Cierra Cursor por completo (⌘Q).

2. Abre el Terminal y ejecuta:

   "/Applications/Trusted Codes.app/Contents/MacOS/tcc-desktop" mcp configure cursor

3. Vuelve a abrir Cursor.

Claude Code (Mac)

Abre el Terminal y ejecuta:

claude mcp add --scope user trusted-codes -- "/Applications/Trusted Codes.app/Contents/MacOS/tcc-desktop" mcp

Después inicia una nueva sesión de Claude Code. No uses mcp configure claude-code: la versión actual escribe un archivo que Claude Code no lee.

Lo que escribe el comando

mcp configure añade una entrada llamada trusted-codes al archivo de ajustes de la aplicación de IA:

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
• Cursor: ~/.cursor/mcp.json

{
  "mcpServers": {
    "trusted-codes": {
      "command": "/Applications/Trusted Codes.app/Contents/MacOS/tcc-desktop",
      "args": ["mcp"]
    }
  }
}

Las demás entradas del archivo se mantienen, con una excepción en la versión actual: si el archivo no se puede leer, por ejemplo tras editarlo a mano con una errata, el comando lo sustituye por un archivo que solo contiene la entrada de Trusted Codes. Si editaste el archivo a mano, haz antes una copia.

Comprobar y quitar

"/Applications/Trusted Codes.app/Contents/MacOS/tcc-desktop" mcp status
"/Applications/Trusted Codes.app/Contents/MacOS/tcc-desktop" mcp remove cursor

status muestra si Claude Desktop y Cursor tienen una entrada trusted-codes. Para Claude Code, ejecuta claude mcp list. Después de remove, cierra la aplicación de IA y vuelve a abrirla.

Cómo funciona la conexión

La aplicación de IA inicia el programa de la aplicación de escritorio como proceso hijo y habla con él en JSON-RPC por la entrada y la salida estándar. Es el único camino por el que un asistente llega a Trusted Codes, y el único en el que está disponible la herramienta del sello de proveedor, porque firma con la clave de esa máquina.

El inicio es inmediato a propósito: sin petición del llavero, sin llamada a la red, sin navegador. No se comprueba nada hasta que el asistente llama a su primera herramienta. Si no has iniciado sesión, esa llamada vuelve como AUTH_REQUIRED; el asistente llama a la herramienta de inicio de sesión, se abre un navegador y lo vuelve a intentar. En un dispositivo nuevo, el inicio de sesión puede responder recovery_required, y el asistente te pedirá las tres palabras de recuperación de la aplicación móvil.

Si tu plan no lo incluye

mcp configure comprueba tu cuenta antes de escribir nada y te avisa si el servidor MCP no forma parte de tu plan. La comprobación es un aviso en el momento en que alguien espera una respuesta, no un bloqueo. El servidor se ejecuta en tu máquina con una clave que ya tienes y calcula los códigos sin conexión, así que ningún servidor puede rechazarlo.