Skip to Content

Endpoint MCP

IronFlock es un servidor MCP. Claude, y cualquier otro cliente que hable el Model Context Protocol, puede listar tus proyectos, leer sus dispositivos, apps y datos, y actuar sobre ellos con las herramientas que ofrece IronFlock, dentro de lo que permite tu clave API. El endpoint forma parte del mismo servicio de API que la API REST y usa las mismas claves API.

Dirección y autenticación

URL en la nube de IronFlockhttps://api.ironflock.com/mcp
URL en un appliancehttps://api. seguido del dominio del appliance y luego /mcp, en cuanto el appliance ejecuta el servicio de API de IronFlock
TransporteStreamable HTTP
AutenticaciónAuthorization: Bearer <your API key>

Crea la clave API en Studio como se describe en Crear una clave API. Cada solicitud lleva la clave. Una solicitud sin clave, o con una que no es válida (eliminada, caducada o de otro IronFlock), recibe HTTP 401. El servidor no ofrece inicio de sesión a través de un navegador (OAuth): la clave es la única forma de entrar.

El servidor no guarda sesiones. Cada solicitud se responde por sí sola, así que un cliente puede conectarse, desconectarse y volver a conectarse libremente. Responde a cada solicitud con un único cuerpo JSON y no tiene ningún flujo de eventos que escuchar.

Conectar Claude

La clave la introduces tú mismo, en la propia configuración de Claude. Nunca la pegues en un chat.

Claude Code

Claude Code se conecta a través del plugin ironflock, que declara el servidor MCP de IronFlock. Funciona en la terminal, en las extensiones para IDE y en la pestaña Code de la app de escritorio de Claude.

  1. Añade el marketplace e instala el plugin en una sesión de Claude Code:

    /plugin marketplace add IronFlock/agent-skills /plugin install ironflock@ironflock
  2. La instalación abre un diálogo con dos ajustes. IronFlock API address es https://api.ironflock.com para la nube, y https://api. seguido del dominio del appliance para un appliance, en ambos casos sin /mcp y sin barra al final. IronFlock API key es la clave de Studio. Claude Code la guarda en el almacén seguro de credenciales del sistema, no en un archivo de configuración.

  3. Reinicia Claude Code. Entonces /mcp muestra el servidor plugin:ironflock:ironflock como conectado.

Cambia los ajustes más tarde con /plugin configure ironflock@ironflock y reinicia Claude Code. Mientras no se haya configurado la clave, el servidor no se inicia. Una instalación desde un shell (claude plugin install) no abre el diálogo, así que complétala con /plugin configure ironflock@ironflock en una sesión. Desarrollar con Claude Code describe los plugins y sus skills.

Claude en la web, en el escritorio y en el teléfono, y Cowork

La conexión propia del plugin solo funciona en Claude Code. En el chat de la app de Claude y en Cowork añades IronFlock una vez como conector personalizado, con la clave como encabezado de solicitud. Los encabezados de solicitud en los conectores personalizados son una beta disponible para un número limitado de organizaciones. Si el diálogo de abajo no tiene la sección Request headers, tu organización todavía no la tiene, y por ahora IronFlock no se puede conectar ahí: Claude Code sí funciona.

  1. Abre Customize > Connectors, elige Add y luego Add custom connector.
  2. Introduce el nombre IronFlock y la URL del servidor https://api.ironflock.com/mcp.
  3. Pon Authentication en No sign-in.
  4. En Request headers, añade el encabezado Authorization con el valor Bearer seguido de tu clave: la palabra Bearer, un espacio y luego la clave. Sin Bearer IronFlock rechaza la solicitud.
  5. Elige Add.

En los planes Team y Enterprise, un propietario añade el conector en Organization settings > Connectors, Add y luego Custom; los encabezados de solicitud pueden estar en Advanced. Todos los que usan ese conector actúan con la única clave que introdujo el propietario, así que dale solo los permisos y los proyectos que todos ellos pueden usar.

Los encabezados de solicitud de un conector no se pueden editar: para cambiar la clave, quita el conector y vuelve a añadirlo. El conector se conecta desde los servidores de Anthropic, así que la dirección tiene que ser accesible desde internet. Es el caso de la nube. Un appliance al que solo llega la red de tu empresa normalmente no se puede conectar ahí, mientras que Claude Code en un ordenador de esa red sí puede.

Otros clientes MCP

Cualquier cliente que admita Streamable HTTP y un encabezado de solicitud se conecta con la URL y el encabezado Authorization: Bearer <your API key>. Mantén la clave fuera de los archivos que compartas o de los que hagas commit.

Comprobar la conexión

Pide a Claude que liste tus proyectos de IronFlock y luego los dispositivos de uno de ellos. Claude llama a list_projects y list_devices, que solo leen.

Herramientas

El servidor ofrece 33 herramientas en estas áreas. La mayoría trabajan en un proyecto y reciben su swarm_key, que proporciona list_projects. Una herramienta que cambia o elimina algo está marcada como tal, para que clientes como Claude puedan preguntarte antes de llamarla.

Proyectos

HerramientaPermisoQué hace
list_projectsdevices:readLista los proyectos en los que puede trabajar la clave

Dispositivos

HerramientaPermisoQué hace
list_devicesdevices:readLista los dispositivos de un proyecto, las apps instaladas en cada uno, si se ejecutan y si el dispositivo está en línea
create_devicedevices:writeCrea un dispositivo en el proyecto y responde con su clave y su nombre
delete_devicedevices:writeElimina un dispositivo del proyecto de forma permanente

Apps en un proyecto

HerramientaPermisoQué hace
list_project_appsapps:readLista las apps instaladas en el proyecto y en cuántos dispositivos se ejecuta cada una
check_app_statusapps:readMuestra si una app se ejecuta en sus dispositivos y si llegan sus datos
install_appapps:writeInstala una app de la tienda en el proyecto y, opcionalmente, en dispositivos
set_app_stateapps:writeInicia o detiene una app instalada en dispositivos
update_appapps:writeActualiza una app instalada a su release más reciente
uninstall_appapps:writeQuita una app de dispositivos, o de todo el proyecto

Tienda de apps y costes

HerramientaPermisoQué hace
search_appsapps:readBusca en la tienda de apps por capacidad y devuelve las apps que coinciden con sus precios
get_app_detailsapps:readLee la descripción, el README y el precio de una a tres apps de la tienda
get_install_quoteapps:readConsulta cuánto costaría instalar una app y qué lo impediría
estimate_project_costapps:readEstima el coste anual de una configuración de proyecto; no se compra nada
sync_app_to_storeapps:writeSolo en un appliance: copia una app de la tienda de la nube de IronFlock en la tienda propia del appliance

Datos

HerramientaPermisoQué hace
get_schemadata:readDescribe la base de datos del proyecto: sus tablas, vistas y columnas
execute_sqldata:readEjecuta una consulta SELECT de solo lectura en la base de datos del proyecto
list_dashboardsdata:readLista los paneles del proyecto
list_app_filesdata:readLista y busca los archivos que una app guarda en el proyecto
read_app_filedata:readLee un archivo que guarda una app: texto, una imagen u otro archivo
save_transformdata:writeCrea o reemplaza una transformación personalizada que mantiene actualizado un valor derivado para los paneles
delete_transformdata:writeElimina una transformación personalizada de forma permanente

Alarmas

HerramientaPermisoQué hace
list_alarmsalarms:readLista las alarmas del proyecto con su estado, sus disparadores y sus destinatarios
create_alarmalarms:writeCrea una alarma que vigila una tabla de datos de una app
update_alarmalarms:writeCambia el disparador o los destinatarios de una alarma, o la pausa y la reanuda
delete_alarmalarms:writeElimina una alarma y su historial de forma permanente

Logs y registro de auditoría

HerramientaPermisoQué hace
get_app_logslogs:readLee la salida de log propia de una app en los dispositivos en los que se ejecuta
get_device_logslogs:readLee lo que ha estado haciendo el propio dispositivo: apps, descargas, disco, red, actualizaciones del agente
query_audit_loglogs:readEjecuta una consulta de solo lectura en el registro de auditoría: quién cambió el proyecto, sus dispositivos, grupos y apps, y cuándo
get_appliance_healthdevices:readSolo en un appliance: comprueba el estado de los servicios de plataforma propios del appliance, el disco, la memoria, la licencia y las actualizaciones
get_appliance_logslogs:readSolo en un appliance: lee el log de una parte de la plataforma del appliance

Herramientas de las apps

Las apps traen herramientas propias con sus agentes de IA: funciones de la app que se ejecutan en un dispositivo, como leer el estado de una máquina o cambiar un ajuste. Dos herramientas llegan a ellas.

HerramientaPermisoQué hace
list_app_toolsapptools:callLista las herramientas de una app instalada, con sus argumentos y las instrucciones de los agentes de la app
call_app_toolapptools:callEjecuta una de ellas en un dispositivo del proyecto

call_app_tool se ejecuta en un dispositivo, y una herramienta de una app puede cambiar cosas allí. El dispositivo tiene que ser uno de los dispositivos del proyecto que el propietario de la clave puede ver, y el propietario necesita el derecho a usar los datos de la app, como al manejar la app desde su panel. La app recibe exactamente los argumentos indicados y nada más. Solo se listan las herramientas del release instalado, no las de la versión de desarrollo de una app. Los textos de una herramienta los escribe el desarrollador de la app y se cortan a una longitud fija.

Permisos

Cada herramienta necesita el permiso que se indica en las tablas de arriba. El servidor solo ofrece a un cliente las herramientas que la clave puede usar, y rechaza cualquier otra herramienta como si no existiera. Permita lo que permita la clave, una herramienta nunca hace más de lo que el propietario de la clave puede hacer en IronFlock. releases:publish no tiene herramienta: es para las operaciones REST que compilan releases. Consulta Permisos para verlos todos, y Crear una clave API para ver cómo elegirlos en Studio.

Una clave restringida a proyectos solo ve esos proyectos. A una clave restringida a una app solo se le ofrecen las herramientas que actúan para una app, así que no list_projects. A ninguna de las dos se le ofrecen las herramientas que van más allá de un proyecto: query_audit_log, cuya consulta puede nombrar recursos de cualquier proyecto que el propietario pueda leer, las dos herramientas del appliance, que no pertenecen a ningún proyecto, y sync_app_to_store, que cambia la tienda del appliance para todos.

Algunas herramientas tienen reglas adicionales:

  • install_app recibe la respuesta de get_install_quote que se te mostró, y no instala nada si desde entonces ha cambiado el precio o cualquier otra cosa de ese presupuesto. Instalar una app de pago cuesta dinero.
  • set_app_state y update_app cambian como máximo 10 dispositivos en una llamada.
  • create_device responde con la clave y el nombre del nuevo dispositivo, y nunca con su archivo de configuración, que contiene las credenciales del dispositivo. Descarga el archivo en Studio, en la configuración del dispositivo, en Mantenimiento > Archivo de configuración del dispositivo > Descargar archivo de configuración, o configura el dispositivo en la máquina con ironflock agent install --project <project> --name <name>, que crea el dispositivo y guarda el archivo en la máquina (Iniciar sesión y gestionar dispositivos).
  • Un proyecto guarda una transformación personalizada a la vez. Un segundo save_transform mientras se ejecuta el primero se rechaza.
  • Una cuenta puede ejecutar query_audit_log una vez a la vez y seis veces por minuto, porque la base de datos que hay detrás es compartida.
  • Un cambio que no termina dentro del tiempo de su llamada puede llegar a hacerse igualmente. El resultado lo dice, y la herramienta no lo repite.

Resultados

Un resultado es JSON, como contenido estructurado y como el mismo JSON en un bloque de texto. Una lista larga se corta para que quepa en 50.000 caracteres, y su miembro cut dice cuántas entradas se omitieron y cómo seguir leyendo. Las imágenes (PNG, JPEG, GIF y WebP) llegan como imágenes, y otros archivos, como un PDF, como recursos incrustados con su tipo de medio.

Cuando una herramienta no puede hacer lo que se pidió, su resultado se marca como error y dice por qué en una frase, por ejemplo que un proyecto no existe o que la plataforma no respondió a tiempo.

Límites

Estos son los valores predeterminados, por clave API:

Límite
Solicitudes120 por minuto, en ráfagas de hasta 30
Solicitudes abiertas a la vez8
Cuerpo de la solicitud1.114.112 bytes: 1 MiB de argumentos y el mensaje que los rodea
Una llamada a una herramienta90 segundos
Una consulta a la base de datos30 segundos; execute_sql responde con 100 filas salvo que pidas más, 1.000 como máximo
Un resultado50.000 caracteres; el resultado de call_app_tool se corta a los 45.000

Errores

RespuestaSignificadoQué hacer
401La clave falta, está mal escrita o cortada, eliminada, caducada o es de otro IronFlock. En un conector, puede faltar Bearer Crea una clave nueva en el Studio del IronFlock al que te conectas e introdúcela de nuevo
404 en /mcp/mcp aparece dos veces en la dirección, o la instancia todavía no ofrece el endpoint, como un appliance que no ejecuta el servicio de API de IronFlockCorrige la dirección; si no, usa la nube
405GET y DELETE en /mcp: el servidor no tiene flujo de eventos ni sesión que terminarUsa POST
413El cuerpo de la solicitud es demasiado grandeEnvía menos en una llamada
429La clave hizo demasiadas solicitudes, o tiene demasiadas abiertas a la vez. El encabezado Retry-After dice cuántos segundos esperarEspera ese tiempo y luego continúa con menos llamadas a la vez
503La plataforma no está disponible en este momento, o el servicio se está apagandoInténtalo de nuevo en un minuto
504La plataforma no respondió a tiempoInténtalo de nuevo en un minuto

Una herramienta que no puede hacer lo que se pidió no responde con un error HTTP: su resultado se marca como error y explica en una frase qué salió mal.

Proteger tu clave

  • Nunca pegues una clave en un chat. Si lo hiciste, forma parte de esa conversación: elimina la clave en Studio, crea una nueva e introdúcela en la configuración.
  • Studio muestra una clave nueva solo una vez, cuando la creas. Guárdala de inmediato en la configuración del cliente.
  • Usa una clave para cada lugar que la use, para poder eliminar una sin romper las demás, y elimina las claves que ya no uses. Una clave es válida durante un año.
  • Da a una clave solo los permisos y los proyectos que Claude necesita: una clave que puede hacer Todo en Todos mis proyectos permite a Claude hacer todo lo que tú puedes hacer en IronFlock. Las herramientas que cambian o eliminan algo están marcadas como tales, para que clientes como Claude puedan preguntarte antes. Lee lo que Claude va a cambiar antes de aceptar.
  • Un conector compartido por una organización actúa con una sola clave para todos sus usuarios. Usa una clave de una cuenta que solo pueda ver lo que todos ellos pueden ver.
Last updated on