Cualquier cliente MCP
Fóir ejecuta un servidor MCP alojado. Conecta tu propio agente y trabaja dentro de los permisos de la persona que lo conectó, o dentro de los alcances de la clave secreta que se le dio.
Un servidor alojado
El servidor está alojado en https://mcp.foir.dev/mcp y habla HTTP Streamable. Cada herramienta llama a los mismos RPC de la plataforma que usan la consola y la CLI, de modo que la validación y el acotado por filas siguen en manos de la plataforma. Las escrituras de registros se guardan como borradores en los modelos con la publicación habilitada, y publicar y borrar son herramientas aparte. Tu agente trae su propio modelo, así que conectarlo no gasta créditos de IA.
Dos formas de autenticarse
La primera es iniciar sesión. Añade la URL del servidor a tu cliente, y el primer uso abre una pantalla de consentimiento de Fóir en tu navegador, donde concedes acceso hasta tu propio nivel. El agente actúa entonces como tú.
La segunda es una clave de API, secreta, que sirve para CI y trabajos desatendidos. foir mcp ejecuta un proxy local hacia el servidor alojado y usa la clave de FOIR_API_KEY cuando está definida. El alcance del agente es entonces el de los propios alcances de la clave. Una clave pública se rechaza.
Qué puede alcanzar un agente con sesión iniciada
Tras iniciar sesión, el token del agente solo puede descubrir aquello a lo que tienes acceso. Tiene que entrar en un espacio de trabajo y, opcionalmente, en un proyecto y una organización, lo que emite un token de trabajo con tus permisos efectivos allí. Los tokens de trabajo duran 30 minutos y se vuelven a emitir, y el espacio de trabajo y el proyecto no pueden elegirse en cada llamada.
La lista de herramientas se filtra en cada solicitud según lo que contiene la credencial, así que dos personas que conectan el mismo agente al mismo proyecto pueden recibir herramientas distintas.
Conexiones de solo lectura
Marca Solo lectura en la pantalla de consentimiento y al agente solo se le ofrecen herramientas de lectura. El consentimiento es el techo sea lo que sea que el agente lea después, así que una instrucción oculta en el contenido no puede convertir una concesión de solo lectura en una escritura. El proxy de la CLI tiene un indicador equivalente para una sesión con sesión iniciada. No puede reducir una clave.
Lee el detalle
La guía de agentes cubre la configuración para cada cliente, la elección de un espacio de trabajo y un proyecto, y lo que un agente puede y no puede hacer.