# Servidor MCP > Connect es MCP-nativo, con tres herramientas que no cambian nunca: search_docs para descubrir, execute para leer y execute_write para escribir, sobre el catálogo completo. El servidor vive en `https://connect.emisso.ai/mcp`: remoto, HTTP, con OAuth 2.1. No hay paquete que instalar. Anuncia tres herramientas, siempre las mismas, con cualquier catálogo: el catálogo completo viaja por dentro, sin inflar el contexto de tu agente. ## Conéctalo a tu cliente [#conéctalo-a-tu-cliente] ### Claude Code [#claude-code] ```bash claude mcp add --transport http connect https://connect.emisso.ai/mcp ``` El comando solo registra el servidor. Para autorizarlo, abre una sesión de Claude Code, escribe `/mcp`, elige `connect` y luego *Authenticate*: se abre el consentimiento de Connect en tu navegador. ### Claude.ai [#claudeai] El botón abre Claude con Emisso Connect ya escrito: A mano: el **+** del cuadro de mensaje, después **Conectores** › *Agregar conector* › *Agregar conector personalizado*, o directo en [claude.ai/customize/connectors](https://claude.ai/customize/connectors), y pega `https://connect.emisso.ai/mcp`. El navegador abre el consentimiento OAuth de Connect: inicias sesión con tu cuenta y autorizas la organización. ### ChatGPT [#chatgpt] Estos pasos son para cuentas personales. En una cuenta de empresa (Business o Enterprise), el modo desarrollador lo habilita un administrador: sigue la [ayuda de OpenAI](https://help.openai.com/es-es/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt). **1. Activa el modo desarrollador.** En ChatGPT: Configuración › Security and login › Developer mode (trae una insignia «ELEVATED RISK»). No hace falta un plan pago: funciona igual en el plan Free. **2. Agrega el servidor MCP.** Entra a [chatgpt.com/plugins](https://chatgpt.com/plugins) y toca el botón «+» para abrir «New Plugin»: ponle un nombre, pega `https://connect.emisso.ai/mcp` en *Server URL* y deja *Authentication* en OAuth, que viene así por defecto. Vas a ver un aviso rojo, «Custom MCP servers introduce risk», con un casillero obligatorio: sin marcarlo, «Create» queda deshabilitado. Es el chequeo de seguridad de ChatGPT, no un problema de Connect. **3. Autoriza en tu navegador.** Se abre una ventana de Connect: inicias sesión y autorizas la organización. ### Cursor [#cursor] ```json { "mcpServers": { "connect": { "url": "https://connect.emisso.ai/mcp" } } } ``` Este formato es de Cursor: no sirve tal cual en VS Code, que usa otra clave (`servers`, no `mcpServers`) y exige `"type": "http"`. ### Otros clientes [#otros-clientes] Cualquier cliente compatible con MCP sobre HTTP sirve: usa la dirección `https://connect.emisso.ai/mcp`. La autorización es OAuth 2.1 con registro dinámico de clientes y PKCE. Tu agente actúa como tú, dentro de tu organización, y su acceso se corta al instante desde [Agentes](https://connect.emisso.ai/agentes): la revocación cierra todas sus sesiones y deja de autenticar en la petición siguiente. El detalle del flujo está en [Autenticación](/docs/empezar/autenticacion). ## Las tres herramientas [#las-tres-herramientas] | Herramienta | Qué hace | | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `search_docs` | Qué existe. Sin argumentos devuelve el índice del catálogo agrupado por sistema (los conectados primero), con `conectado` por sistema y `id`, una línea de descripción, `disponible` y `puerta` por tool, más `ahora`: la fecha y el mes en curso en hora de Chile, para «este mes» o «el mes pasado». Con `{ "tool": "sii.rcv.consultar" }` devuelve la ficha completa con sus esquemas de entrada y salida y un ejemplo ejecutable. Llámala primero. | | `execute` | Correr una tool de **solo lectura**: `{ tool, params, connectionId }`. `params` es obligatorio (`{}` si no toma argumentos). `connectionId` va siempre explícito en todo sistema conectable: la conexión es la empresa y el servidor no la elige. Si hay una sola conexión activa con esa tool, el agente la usa sin preguntar. Si le pasas una tool que escribe, responde `validation_error` con el llamado correcto ya armado por `execute_write`. | | `execute_write` | Correr una tool que **escribe**: sincronizar, verificar, emitir, anular o reenviar un documento, y crear un enlace de conexión. Acepta `{ tool, params, connectionId, idempotencyKey? }`. También acepta una tool de solo lectura. | Un catálogo completo como tools nativas quema la ventana de contexto del agente y cambia de forma con cada conector nuevo. Un puñado fijo de meta-tools la mantiene constante. Es el mismo argumento con el que Stripe migró su servidor MCP a `stripe_api_search` y compañía; Connect llegó a este diseño primero. `execute` declara `readOnlyHint: true`: un cliente MCP puede correrla sin pedir confirmación en cada llamada. `execute_write` declara `destructiveHint: true` y sigue pidiéndola. La ficha de `search_docs` nombra la puerta de cada tool en el campo `puerta`, así que nunca hace falta adivinar. ## Clave de idempotencia por operación [#clave-de-idempotencia-por-operación] `execute_write` permite enviar `idempotencyKey` como argumento, fuera de `params`, sin configurar headers HTTP en tu cliente MCP. Usa un UUID v4 nuevo, en minúsculas, generado por el cliente para cada operación distinta. La ficha de `search_docs` indica cuándo la tool exige esta clave y la incluye en su ejemplo. ```json { "tool": "", "params": {}, "connectionId": "", "idempotencyKey": "" } ``` Conserva la clave y los argumentos originales para recuperar la misma operación. Si el resultado indica incertidumbre, no reintentes ni generes otra clave: sigue sus instrucciones de reconciliación o soporte. Una clave distinta representa otra operación y no evita una duplicación. El header HTTP `Idempotency-Key` sigue funcionando para clientes existentes. Si envías header y argumento, deben coincidir; de lo contrario recibes `validation_error` antes de ejecutar la tool. Las tools que no exigen una clave explícita mantienen su comportamiento cuando la omites. REST conserva el header. ## El recorrido que tu agente va a seguir [#el-recorrido-que-tu-agente-va-a-seguir] 1. `search_docs` para ver los sistemas y qué está `conectado`. 2. `execute { "tool": "conexiones.estado.consultar", "params": {} }` para obtener los `connectionId` y el campo `datosListos`. 3. `execute` de la tool de negocio con su `connectionId`: por ejemplo el RCV de julio. 4. Si un sistema aparece con `conectado: false`, el camino es `execute_write { "tool": "conexiones.enlace.crear", "params": { "sistema": "" } }`: el agente crea el enlace y **se lo muestra al humano** con el dominio visible. La clave la entrega la persona, nunca el agente. ## Prompt de arranque [#prompt-de-arranque] Para darle Connect a un agente con las reglas ya aprendidas: ```text Tienes Emisso Connect (https://connect.emisso.ai/mcp): el puente a los sistemas chilenos de esta organización (SII, bancos, Previred, indicadores). Reglas: 1. Parte siempre por search_docs. Sin argumentos trae el índice de herramientas por sistema, con su puerta (execute para leer, execute_write para escribir): usa solo los ids que aparecen ahí. Con {tool: ""} trae la ficha completa: esquema de argumentos y un ejemplo ejecutable. 2. connectionId va siempre explícito en la llamada; sácalo de conexiones.estado.consultar. Considera solo las conexiones activas que tengan la herramienta que necesitas: si queda una, úsala; si quedan varias, pregunta cuál. Antes de escribir (emitir, sincronizar o crear un enlace), confirma la empresa con la persona. 3. En el SII, los bancos y Previred, leer son dos pasos: .conexion.sincronizar escribe (con execute_write; se encola y vuelve al instante con un jobId, sin datos) y .consultar lee lo ya guardado (con execute). Sincronizar requiere un plan activo: sin plan responde 402 subscription_required. Una lista vacía puede ser un período sin sincronizar: revisa datosListos en conexiones.estado.consultar antes de concluir que no hay nada. Notta y los indicadores no se sincronizan: se leen directo con execute. 4. Si un sistema aparece con conectado: false, crea un enlace con execute_write y conexiones.enlace.crear, y muéstralo con su dominio completo visible, explicando quién lo pidió y para qué. Nunca lo presentes como un aviso del banco ni del SII. 5. Ante un error, sigue el suggested_fix que viene en la respuesta; no reintentes lo que no es reintentable. Si no reconoces el error, reporta el request_id. ``` ## Qué hace solo y qué no [#qué-hace-solo-y-qué-no] | Acción | ¿La hace solo? | | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | Descubrir el catálogo, consultar estados, leer datos sincronizados | Sí | | Disparar una sincronización a pedido | Sí, y sin esperar: la llamada vuelve al instante con el `jobId`, y el trabajo corre en segundo plano | | Crear el enlace de conexión | Sí, pero la clave la entrega el humano en la página del enlace | | Deshabilitar o habilitar una conexión | Solo si la clave o el token tiene `conexiones:disable` o `conexiones:enable`. Habilitarla vuelve a sumarla al cobro, y la respuesta dice cuánto | | Eliminar una conexión | Solo si la clave o el token tiene `conexiones:delete` y con el nombre exacto de la conexión. Es irreversible: pídelo solo cuando la persona lo decidió | | Ver o tocar una credencial | Nunca. El vault es inaccesible por diseño, también para el agente | ## Compatibilidad [#compatibilidad] `tools/call` acepta solo las tres herramientas. Un nombre nativo de antes de las meta-tools (`sii__rcv__consultar`, con doble guion bajo) o un id con puntos responde `tool_not_found`, con la indicación de usar `execute` o `execute_write`. Si tu cliente guardó esos nombres, pásalos como `tool` dentro de `execute` o `execute_write`: ahí la codificación con doble guion bajo todavía se traduce al id con puntos, que es la forma canónica que entrega `search_docs`. ## Próximos pasos [#próximos-pasos] * [Consultar con Claude](/docs/como-consultar/claude) o [con ChatGPT](/docs/como-consultar/chatgpt): una consulta completa, animada, con las llamadas que hace el agente. * [Recursos máquina-legibles](/docs/agentes/recursos): llms.txt, markdown por página y el OpenAPI completo. * [Conecta tu primera empresa](/docs/empezar/conectar): el flujo que tu agente va a iniciar.