# MCP (herramientas externas)

> Qué es MCP, qué ves hoy en Orkan y cómo se configuran los servidores y las conexiones, que por ahora se hace por la API.

**MCP** es una forma estándar de conectar herramientas de otros servicios con una IA. En Orkan sirve en dos sentidos:

-   **Servidores MCP:** tu Orkan ofrece algunas de sus automatizaciones como herramientas, para que otros programas con IA las usen.
-   **Conexiones MCP:** tus asistentes pueden usar las herramientas que ofrece otro servicio, solo las que tú permitas.

> **Hoy es de consulta**
>
> Hoy es de consulta
> 
> Es una función de uso avanzado y **todavía no se configura desde la interfaz**. La pantalla solo te deja **ver** lo que hay y actualizar las herramientas de una conexión. Crear o cambiar un servidor se hace por la [API](https://wiki.itsorkan.com/desarrolladores/api/).

## Qué ves en Orkan

Activa el **Modo avanzado** en **Ajustes › Avanzado**. En **Ajustes › Asistentes de IA** aparece la pestaña **MCP**:

-   **Servidores MCP**: para cada servidor, su nombre, qué **automatizaciones ofrece** como herramientas y si **pide autorización**.
-   **Conexiones MCP**: las herramientas de otros servicios que tus asistentes pueden usar. Cada conexión muestra su dirección, si cuenta con tu permiso y la **lista de herramientas permitidas**. Una conexión sin herramientas permitidas no deja usar ninguna.
-   **Actualizar herramientas** vuelve a consultar al otro servicio y muestra las **herramientas encontradas**, con su descripción y los datos que necesita cada una.

## Cómo se configura

Con una clave de API (mira [la API](https://wiki.itsorkan.com/desarrolladores/api/)):

-   `GET /v1/mcp/servers` y `GET /v1/mcp/connections` listan servidores y conexiones.
-   `PUT /v1/mcp/servers/{server_id}` cambia el nombre de un servidor y las automatizaciones **activadas** que ofrece.
-   `POST /v1/mcp/connections/{credential_id}/tools:refresh` actualiza las herramientas de una conexión.
-   `POST /v1/mcp` es el punto de entrada del propio servidor MCP: habla JSON-RPC 2.0 (`initialize`, `tools/list`, `tools/call`) y se autentica con una clave de API.

Esas rutas necesitan permisos concretos (ver y gestionar las herramientas conectadas a la IA, usarlas en un proyecto), que se dan al crear la clave. Todo uso queda en la **Actividad** de la organización.

## Límites

-   Hay que activar el modo avanzado para ver la pestaña.
-   No se crean servidores ni conexiones desde la interfaz; la API puede cambiar. Mira [la API](https://wiki.itsorkan.com/desarrolladores/api/).
-   Un servidor solo puede ofrecer automatizaciones activadas.
-   Si algo no encaja con lo que necesitas, [pregunta en el foro](https://forum.itsorkan.com) o [escríbenos](mailto:contact@gnevoo.es).