Configurar el servidor MCP de Attio en Claude Code
Conecta un agente a la CLI de Attio por MCP, mira qué se le ofrece y mantén tuyas sus escrituras.
MCP y skills →Qué aporta MCP, cómo conectar tu cliente y cómo leer esta documentación.Da tus negociaciones, personas y empresas de Attio a un agente de IA que no puede ejecutar comandos, como Claude
Desktop, Cursor, o ChatGPT y Claude en el navegador. MCP (Model Context Protocol) es la forma en que un agente así
pregunta a un programa qué sabe hacer y luego lo llama, y attio ofrece sus comandos de esa forma.
Después el agente lee tus negociaciones, tu embudo y los cambios desde la copia de tu ordenador, y busca personas y empresas en Attio, hasta donde lo permiten los permisos del perfil.
A un agente con terminal, como Claude Code o Codex, le van igual de bien los comandos y la skill
(attio skill install). Necesitas un perfil con sesión iniciada (instala), y antes mirar los
permisos: por MCP una escritura en ask sigue adelante.
En esta página:
- Añade attio a un agente
- Lo que ve el agente
- Las escrituras siguen siendo tuyas
- ChatGPT y Claude en el navegador
Añade attio a un agente
attio work mcp add claude-code --allow-writes # or codex
attio work mcp check # the handshake and the tool list, as the client sees them--allow-writes dice que sabes que el perfil ofrece herramientas que escriben: las escrituras del grupo api. Para
Claude Desktop, Cursor o cualquier otro cliente, attio work mcp config imprime la entrada que hay que pegar en sus
ajustes, con rutas completas. A mano, para Claude Code:
claude mcp add attio -- attio work mcp serveUn servidor puede atender varios perfiles: attio mcp serve --profiles work,client, o --profiles all. Entonces cada
llamada nombra su perfil, y el agente te pregunta si no dijiste cuál.
Lo que ve el agente
El servidor tiene tres herramientas:
attio_tools_searchencuentra un comando por palabras, con sus argumentos y la forma de su respuesta.attio_readejecuta un comando que solo lee:{ "command": "deals list", "arguments": { "query": "status:open" } }.attio_writeejecuta un comando que escribe, como una operación deapique crea o borra un registro.
Un comando se nombra como en la línea de comandos, sin el perfil, y comprueba la misma clave de permiso.
El texto de Attio llega marcado como untrusted: los títulos de negociaciones, los nombres de etapas, los nombres de
personas y empresas, los valores de atributos y lo que encuentra search all. Al agente se le dice que son datos,
nunca instrucciones.
Las escrituras siguen siendo tuyas
Los comandos de negociaciones, personas y empresas solo leen. El grupo api llega a cada operación de Attio, y sus
escrituras están en allow por defecto, sus borrados en ask. Por MCP no hay nadie en una terminal para responder a
ask, así que un borrado también sigue adelante.
Dos cosas detienen una escritura. Usa al menos una antes de añadir el servidor:
-
Los ámbitos del token. Un token con solo los tres ámbitos de lectura de instala no puede escribir: Attio lo rechaza.
-
Los permisos del perfil. Esta línea aleja toda escritura de
apide cualquier agente de este perfil, y las lecturas siguen funcionando:attio work config set permissions.api readonly
Para que un servidor sea más estricto que el perfil, dale sus propios niveles. Nunca aflojan el perfil:
attio work mcp add claude-code --allow-writes --permission api=readonly
attio work mcp serve --permission api.objects-records-delete=denyO activa la aprobación de la herramienta attio_write en el cliente de tu agente, para que el cliente te pregunte
antes de cada escritura.
ChatGPT y Claude en el navegador
Una aplicación del navegador llega al servidor por HTTP a través de tu propio túnel, como Tailscale Funnel:
attio work mcp serve --http --public-url https://laptop.example.ts.netEl servidor escucha solo en 127.0.0.1, puerto 8765 (--port lo cambia). Una aplicación del navegador inicia sesión
con un código de un solo uso que imprime el comando. attio work mcp revoke termina todos los inicios de sesión.
attio work mcp server start ejecuta el mismo servidor en segundo plano. mcp server status muestra su puerto, el
código de inicio de sesión y las aplicaciones conectadas, y mcp server stop lo detiene.