Ir al contenido

MCP (herramientas externas)

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.

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.

Con una clave de API (mira la 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.

  • 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.
  • Un servidor solo puede ofrecer automatizaciones activadas.
  • Si algo no encaja con lo que necesitas, pregunta en el foro o escríbenos.