# Conexiones MCP

> Gestiona en un solo lugar las conexiones de herramientas reutilizables y actívalas solo para los Agents que de verdad las necesitan.

Source: https://docs.syfo.ai/es/docs/mcp-connections

MCP (Model Context Protocol) es un protocolo estándar para conectar herramientas. Al crear una conexión MCP en Syfo, puedes poner herramientas externas como Linear o una API interna a disposición de los Agents. Una conexión se crea una vez y se puede activar para varios Agents; solo los Agents que la tienen activada pueden usarla.

Acceso: "Settings › MCP connections". También puedes crearla directamente en la pestaña "MCP" de la página de detalles del Agent.

## Paso 1: crear la conexión

1.  Ve a "Settings › MCP connections" y haz clic en "Create connection".
2.  Completa "Name" y "Description" (para qué sirve la conexión).
3.  Elige el "Scope" (alcance):
    -   **Personal**: solo tú la ves y solo puedes activarla para Agents de los que eres responsable.
    -   **Organization**: visible para toda la organización; cualquier Agent puede activarla. Solo el Owner o un Admin de la organización pueden crearla y editarla.

    El alcance se fija al crear la conexión y no se puede cambiar después.

## Paso 2: elegir el transporte y completar la configuración

| Transporte | Adecuado para | Qué completar |
| --- | --- | --- |
| Streamable HTTP | Servicios MCP remotos | URL; si requiere autenticación, completa "Token", que se inyecta como Bearer token |
| stdio | Programas MCP locales que se inician en la computadora del Agent | Command, Args (un argumento por línea); las claves van en "Environment variables" y se inyectan en las variables de entorno del proceso |

-   Después de guardar, el token y las variables de entorno ya no muestran su valor original, solo el nombre.
-   Si ya tienes una configuración JSON, cambia a "Advanced JSON" y pégala directamente.
-   Al crear una conexión stdio desde la pestaña "MCP" de un Agent, puedes marcar "Bind to this computer" (vincular a esta computadora): el comando y las claves solo se ejecutarán y enviarán en esa computadora. Si no lo marcas, cualquier computadora donde esté un Agent con esta conexión activada ejecutará el comando y recibirá las claves.

Cuando termines la configuración, haz clic en "Create connection".

## Paso 3: probar

En la lista de conexiones, haz clic en "Test". El resultado puede ser:

-   **Reachable**: el servicio responde.
-   **Auth required**: el servicio responde, pero necesita credenciales correctas.
-   **Unreachable**: no se puede conectar; revisa la URL y la red.
-   **Error response**: el servicio devolvió un error.

Las conexiones stdio se ejecutan en la computadora del Agent y el servidor no puede probarlas, así que se muestra "stdio: test on agent host". En ese caso pasa directamente al siguiente paso y revisa el estado de ejecución después de activarla.

## Paso 4: activarla para un Agent

1.  Abre la página de detalles del Agent y ve a la pestaña "MCP".
2.  En "Available connections", busca la conexión y haz clic en "Enable". Solo el responsable del Agent puede activarla o desactivarla.
3.  La página mostrará "MCP changes saved. If the Agent is currently running, restart it for the changes to take effect." Haz clic en el botón del aviso para reiniciar el Agent.

Cuando ya no la necesites, haz clic en "Disable"; también hay que reiniciar el Agent para que tenga efecto.

## Paso 5: ver el estado de ejecución

Después de reiniciar, vuelve a la pestaña "MCP" del Agent para ver el estado de cada conexión:

-   **Runtime health verified**: MCP se inicializó correctamente y el Agent puede usarlo.
-   **Runtime detected an unavailable MCP**: se indica el motivo, por ejemplo un fallo de autenticación, que no se pudo conectar al servicio, o que a la computadora del Agent le falta un comando, directorio, permiso o variable de entorno necesario.
-   **Runtime health not verified**: todavía no hay resultado de ejecución; normalmente el Agent aún no se ha reiniciado o todavía no la ha usado.

## Qué es "Inherited from runtime"

Debajo de la pestaña "MCP" del Agent hay también un grupo "Inherited from runtime · read-only" (heredado del runtime, solo lectura). Son los MCP que el runtime del Agent (por ejemplo, Codex o Claude Code) tiene configurados por su cuenta en esa computadora. Los gestiona el runtime; Syfo solo los muestra y no permite activarlos, desactivarlos ni editarlos.

Las conexiones creadas en Syfo no se heredan automáticamente de Skills, canales ni computadoras: hay que activarlas explícitamente en cada Agent.

## Gestionar, revocar y eliminar

En "Settings › MCP connections", haz clic en "Manage" para modificar la configuración, ver "Agents using this connection" y desvincularlos uno a uno con "Unbind" o todos a la vez con "Unbind all".

-   Después de modificar la configuración, los Agents en ejecución deben reiniciarse para usar la nueva configuración.
-   Si haces clic en "Revoke" en una conexión que está en uso, todos los Agents que la usan perderán ese MCP en su próximo reinicio.
-   No se puede eliminar una conexión que algún Agent está usando; primero desactívala en cada Agent. La eliminación no se puede deshacer.

## Credenciales y permisos

-   Usa credenciales dedicadas y con los mínimos permisos.
-   No pegues claves en el canal ni en el prompt del Agent. Las credenciales que deban guardarse a largo plazo y concederse a Agents van en la [bóveda](https://docs.syfo.ai/es/docs/vault).
-   Si los límites de cliente o de entorno son distintos, sepáralos en conexiones y credenciales diferentes.
-   Cuando un Agent o un proyecto ya no la necesite, desactiva la conexión y rota o revoca las credenciales.

## Solución de problemas

Si la prueba de conexión sale bien pero el Agent sigue sin poder usarla, revisa en este orden:

1.  Si la conexión está activada ("Enable") en la pestaña "MCP" de este Agent.
2.  Si reiniciaste el Agent después de activarla o modificarla.
3.  El estado de ejecución y el motivo del error en la pestaña "MCP".
4.  El alcance de permisos de la credencial y la configuración de permisos del propio servicio externo.

:::note
Que la prueba salga bien solo significa que el servicio responde, no que todos los Agents puedan usarlo. Un Agent solo puede usar las conexiones que tiene activadas.
:::