Conectá tu asistente de IA a Boolfy Agents para consultar los datos extraídos de tus facturas y comprobantes, y para cargar documentos nuevos.
Qué es
Boolfy Agents lee facturas y comprobantes con IA y extrae sus datos. El servidor MCP (Model Context Protocol) permite que asistentes de IA como Claude, ChatGPT, Cursor, VS Code Copilot, Gemini, Grok y otros consulten esos datos y carguen documentos, siempre con los permisos de tu usuario.
El servidor está publicado en el MCP Registry oficial con el nombre com.boolfy/agents.
Requisitos
- Una cuenta de Boolfy Agents.
- Un cliente de IA compatible con servidores MCP remotos por HTTP y autenticación OAuth. Algunos clientes limitan esta función según el plan; lo indicamos en cada caso.
URL del servidor
https://agents.boolfy.com/api/mcp- Transporte
- Streamable HTTP
- Versión del protocolo
- 2025-06-18
- Autenticación
- OAuth 2.1 con PKCE (sin API keys)
Cómo conectarlo
En todos los casos, la primera vez que el asistente use el servidor se abre una ventana para iniciar sesión con tu cuenta de Boolfy y aprobar el acceso. Las interfaces de cada cliente cambian seguido: si algo no coincide, seguí la documentación oficial enlazada.
Claude
Claude (web y escritorio): conector personalizado
- Abrí Customize > Connectors.
- Hacé clic en Add, pasá el cursor por Custom y elegí Web.
- Poné un nombre (por ejemplo,
Boolfy Agents) y la URLhttps://agents.boolfy.com/api/mcp. Hacé clic en Continue. - Revisá la configuración de autenticación detectada, dejá OAuth y hacé clic en Add.
- Conectá el conector e iniciá sesión con tu cuenta de Boolfy.
Según la documentación de Anthropic, los conectores personalizados están disponibles en los planes Free (un solo conector personalizado), Pro, Max, Team y Enterprise. En Team y Enterprise, un owner de la organización tiene que agregarlo primero desde Organization settings > Connectors; después cada persona se conecta con su propia cuenta.
Documentación oficial: Get started with custom connectors using remote MCP · Use connectors to extend Claude's capabilities
Claude Code
claude mcp add --transport http boolfy-agents https://agents.boolfy.com/api/mcpDespués, dentro de Claude Code, ejecutá /mcp e iniciá sesión en el navegador (o usá claude mcp login boolfy-agents desde la terminal).
Documentación oficial: Connect Claude Code to tools via MCP
ChatGPT
- En ChatGPT web, andá a Plugins.
- Seleccioná el botón + y luego Add custom MCP server.
- Ingresá un nombre y, en Connection, la URL
https://agents.boolfy.com/api/mcp. - Elegí OAuth como autenticación.
- Leé la advertencia de riesgo, marcá I understand and want to continue y seleccioná Create as a plugin.
- Iniciá sesión con tu cuenta de Boolfy y revisá las herramientas detectadas.
- En una conversación nueva, escribí
@y elegí el plugin.
Según la documentación de OpenAI, la conexión de servidores MCP personalizados con soporte MCP completo (incluidas acciones de escritura, como upload_document) está disponible en ChatGPT Business y Enterprise/Edu, solo en la web y sujeta a los permisos del workspace: en Business solo admins y owners pueden crearlos y publicarlos. Los usuarios Pro pueden conectar servidores MCP personalizados solo con permisos de lectura. No está disponible en la app móvil.
Documentación oficial: Connecting custom MCP servers in ChatGPT
Cursor
O agregalo a mano en ~/.cursor/mcp.json (global) o .cursor/mcp.json (proyecto):
{
"mcpServers": {
"boolfy-agents": {
"url": "https://agents.boolfy.com/api/mcp"
}
}
}Cursor te va a pedir iniciar sesión con OAuth la primera vez.
Documentación oficial: MCP Install Links · Model Context Protocol (MCP)
VS Code (GitHub Copilot)
Instalar en VS Code · Instalar en VS Code Insiders
También podés ejecutar MCP: Add Server desde la paleta de comandos, elegir HTTP y pegar la URL, o agregarlo en .vscode/mcp.json:
{
"servers": {
"boolfy-agents": {
"type": "http",
"url": "https://agents.boolfy.com/api/mcp"
}
}
}Aceptá el aviso de confianza e iniciá sesión con tu cuenta de Boolfy cuando VS Code lo pida.
Documentación oficial: MCP developer guide (URL de instalación) · Add MCP servers in VS Code · MCP configuration reference
Otros clientes (Gemini, Grok y más)
Cualquier cliente MCP que soporte servidores remotos por HTTP (Streamable HTTP) con OAuth puede conectarse. En general alcanza con:
- Agregar un servidor MCP remoto con la URL
https://agents.boolfy.com/api/mcp. - Elegir autenticación OAuth (el cliente descubre el servidor de autorización automáticamente).
- Iniciar sesión con tu cuenta de Boolfy y aprobar el acceso.
Consultá la documentación de tu cliente para ver dónde se configuran los servidores MCP.
Autenticación y permisos
El acceso usa OAuth 2.1 con PKCE a través de https://auth.boolfy.com, con registro dinámico de clientes y Client ID Metadata Documents. Iniciás sesión con tu cuenta de Boolfy y aprobás el acceso. No hay API keys.
| Scope | Permite |
|---|---|
agents.read | Leer agentes, datasets, documentos y proveedores. |
agents.documents.write | Cargar documentos. |
Los datos siempre quedan restringidos a tu propia empresa (ente): el asistente solo ve lo que ve tu usuario.
Revocar el acceso
Podés desconectar o eliminar el servidor desde la configuración de tu cliente de IA. Para revocar el acceso otorgado a un cliente, escribinos a soporte@boolfy.com.
Herramientas
Seis herramientas son de solo lectura. Solo upload_document escribe, y únicamente crea documentos nuevos.
| Herramienta | Qué hace | Tipo |
|---|---|---|
list_agents | Lista los agentes disponibles para la empresa del usuario. Devuelve el código de cada agente, que se usa en las demás herramientas. | Solo lectura |
describe_agent(agent_code) | Describe los datasets del agente (documents = un registro por documento; documents_<tabla> = una fila por línea de tabla), sus campos, tipos y operadores de filtro. | Solo lectura |
query_dataset(agent_code, dataset_code, …) | Devuelve registros reales de documentos terminados o enviados, sin eliminados. Parámetros: Operadores: Los campos de CUIT tienen columnas virtuales | Solo lectura |
get_document(identifier) | Devuelve el estado y los datos extraídos de un documento. Fechas en formato dd/mm/aaaa. | Solo lectura |
upload_document(agent_code, filename, content_base64, external_code?, context?, bag?) | Carga un PDF, imagen, TIFF o Excel (máximo 10 MB por defecto). El procesamiento es asincrónico: consultá el resultado con get_document. Requiere agents.documents.write. Crea un documento nuevo en cada llamada; no borra ni modifica nada. | Escritura (crea documentos) |
get_supplier(tax_code) | Devuelve los datos del maestro de proveedores por CUIT/CUIL: razón social, nombre de fantasía, condición IVA, estado, código ERP, país y domicilio fiscal. Valida el dígito verificador. No consulta ARCA. | Solo lectura |
list_suppliers(name?, tax_code?, …) | Busca en el maestro de proveedores, sin distinguir mayúsculas ni acentos. Parámetros: limit (por defecto 50, máximo 200) y cursor. | Solo lectura |
Ejemplos de preguntas
- «¿Cuánto me facturó cada proveedor en septiembre?»
- «Mostrame las facturas pendientes de aprobar.»
- «Cargá esta factura en el agente Facturas AR.»
- «¿Qué condición de IVA tiene el proveedor con CUIT 30-12345678-9?»
- «¿En qué estado está el documento que cargué recién?»
Límites
| Concepto | Límite |
|---|---|
query_dataset: registros por página | 50 por defecto, máximo 500 (paginación con offset o cursor) |
list_suppliers: resultados por página | 50 por defecto, máximo 200 (paginación con cursor) |
upload_document: tamaño de archivo | 10 MB por defecto |
upload_document: formatos | PDF, imagen, TIFF, Excel |
| Documentos incluidos en consultas | Terminados o enviados; nunca eliminados |
Privacidad y seguridad
- Autenticación con OAuth 2.1 y PKCE; no se usan API keys.
- Aislamiento por empresa: cada usuario accede solo a los datos de su propia empresa.
- Todas las herramientas son de solo lectura, salvo
upload_document, que solo crea documentos nuevos y requiere el permisoagents.documents.write.
