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 IronFlock | https://api.ironflock.com/mcp |
| URL en un appliance | https://api. seguido del dominio del appliance y luego /mcp, en cuanto el appliance ejecuta el servicio de API de IronFlock |
| Transporte | Streamable HTTP |
| Autenticación | Authorization: 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.
-
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 -
La instalación abre un diálogo con dos ajustes. IronFlock API address es
https://api.ironflock.compara la nube, yhttps://api.seguido del dominio del appliance para un appliance, en ambos casos sin/mcpy 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. -
Reinicia Claude Code. Entonces
/mcpmuestra el servidorplugin:ironflock:ironflockcomo 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.
- Abre Customize > Connectors, elige Add y luego Add custom connector.
- Introduce el nombre
IronFlocky la URL del servidorhttps://api.ironflock.com/mcp. - Pon Authentication en No sign-in.
- En Request headers, añade el encabezado
Authorizationcon el valorBearerseguido de tu clave: la palabra Bearer, un espacio y luego la clave. SinBearerIronFlock rechaza la solicitud. - 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
| Herramienta | Permiso | Qué hace |
|---|---|---|
list_projects | devices:read | Lista los proyectos en los que puede trabajar la clave |
Dispositivos
| Herramienta | Permiso | Qué hace |
|---|---|---|
list_devices | devices:read | Lista los dispositivos de un proyecto, las apps instaladas en cada uno, si se ejecutan y si el dispositivo está en línea |
create_device | devices:write | Crea un dispositivo en el proyecto y responde con su clave y su nombre |
delete_device | devices:write | Elimina un dispositivo del proyecto de forma permanente |
Apps en un proyecto
| Herramienta | Permiso | Qué hace |
|---|---|---|
list_project_apps | apps:read | Lista las apps instaladas en el proyecto y en cuántos dispositivos se ejecuta cada una |
check_app_status | apps:read | Muestra si una app se ejecuta en sus dispositivos y si llegan sus datos |
install_app | apps:write | Instala una app de la tienda en el proyecto y, opcionalmente, en dispositivos |
set_app_state | apps:write | Inicia o detiene una app instalada en dispositivos |
update_app | apps:write | Actualiza una app instalada a su release más reciente |
uninstall_app | apps:write | Quita una app de dispositivos, o de todo el proyecto |
Tienda de apps y costes
| Herramienta | Permiso | Qué hace |
|---|---|---|
search_apps | apps:read | Busca en la tienda de apps por capacidad y devuelve las apps que coinciden con sus precios |
get_app_details | apps:read | Lee la descripción, el README y el precio de una a tres apps de la tienda |
get_install_quote | apps:read | Consulta cuánto costaría instalar una app y qué lo impediría |
estimate_project_cost | apps:read | Estima el coste anual de una configuración de proyecto; no se compra nada |
sync_app_to_store | apps:write | Solo en un appliance: copia una app de la tienda de la nube de IronFlock en la tienda propia del appliance |
Datos
| Herramienta | Permiso | Qué hace |
|---|---|---|
get_schema | data:read | Describe la base de datos del proyecto: sus tablas, vistas y columnas |
execute_sql | data:read | Ejecuta una consulta SELECT de solo lectura en la base de datos del proyecto |
list_dashboards | data:read | Lista los paneles del proyecto |
list_app_files | data:read | Lista y busca los archivos que una app guarda en el proyecto |
read_app_file | data:read | Lee un archivo que guarda una app: texto, una imagen u otro archivo |
save_transform | data:write | Crea o reemplaza una transformación personalizada que mantiene actualizado un valor derivado para los paneles |
delete_transform | data:write | Elimina una transformación personalizada de forma permanente |
Alarmas
| Herramienta | Permiso | Qué hace |
|---|---|---|
list_alarms | alarms:read | Lista las alarmas del proyecto con su estado, sus disparadores y sus destinatarios |
create_alarm | alarms:write | Crea una alarma que vigila una tabla de datos de una app |
update_alarm | alarms:write | Cambia el disparador o los destinatarios de una alarma, o la pausa y la reanuda |
delete_alarm | alarms:write | Elimina una alarma y su historial de forma permanente |
Logs y registro de auditoría
| Herramienta | Permiso | Qué hace |
|---|---|---|
get_app_logs | logs:read | Lee la salida de log propia de una app en los dispositivos en los que se ejecuta |
get_device_logs | logs:read | Lee lo que ha estado haciendo el propio dispositivo: apps, descargas, disco, red, actualizaciones del agente |
query_audit_log | logs:read | Ejecuta 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_health | devices:read | Solo 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_logs | logs:read | Solo 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.
| Herramienta | Permiso | Qué hace |
|---|---|---|
list_app_tools | apptools:call | Lista las herramientas de una app instalada, con sus argumentos y las instrucciones de los agentes de la app |
call_app_tool | apptools:call | Ejecuta 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_apprecibe la respuesta deget_install_quoteque 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_stateyupdate_appcambian como máximo 10 dispositivos en una llamada.create_deviceresponde 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 conironflock 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_transformmientras se ejecuta el primero se rechaza. - Una cuenta puede ejecutar
query_audit_loguna 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 | |
|---|---|
| Solicitudes | 120 por minuto, en ráfagas de hasta 30 |
| Solicitudes abiertas a la vez | 8 |
| Cuerpo de la solicitud | 1.114.112 bytes: 1 MiB de argumentos y el mensaje que los rodea |
| Una llamada a una herramienta | 90 segundos |
| Una consulta a la base de datos | 30 segundos; execute_sql responde con 100 filas salvo que pidas más, 1.000 como máximo |
| Un resultado | 50.000 caracteres; el resultado de call_app_tool se corta a los 45.000 |
Errores
| Respuesta | Significado | Qué hacer |
|---|---|---|
401 | La 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 IronFlock | Corrige la dirección; si no, usa la nube |
405 | GET y DELETE en /mcp: el servidor no tiene flujo de eventos ni sesión que terminar | Usa POST |
413 | El cuerpo de la solicitud es demasiado grande | Envía menos en una llamada |
429 | La clave hizo demasiadas solicitudes, o tiene demasiadas abiertas a la vez. El encabezado Retry-After dice cuántos segundos esperar | Espera ese tiempo y luego continúa con menos llamadas a la vez |
503 | La plataforma no está disponible en este momento, o el servicio se está apagando | Inténtalo de nuevo en un minuto |
504 | La plataforma no respondió a tiempo | Inté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.