Servidor MCP de Boolfy Agents

Por Boolfy · Actualizado el

Servidor MCP de Boolfy Agents

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

  1. Abrí Customize > Connectors.
  2. Hacé clic en Add, pasá el cursor por Custom y elegí Web.
  3. Poné un nombre (por ejemplo, Boolfy Agents) y la URL https://agents.boolfy.com/api/mcp. Hacé clic en Continue.
  4. Revisá la configuración de autenticación detectada, dejá OAuth y hacé clic en Add.
  5. 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.

Claude Code

claude mcp add --transport http boolfy-agents https://agents.boolfy.com/api/mcp

Después, dentro de Claude Code, ejecutá /mcp e iniciá sesión en el navegador (o usá claude mcp login boolfy-agents desde la terminal).

ChatGPT

  1. En ChatGPT web, andá a Plugins.
  2. Seleccioná el botón + y luego Add custom MCP server.
  3. Ingresá un nombre y, en Connection, la URL https://agents.boolfy.com/api/mcp.
  4. Elegí OAuth como autenticación.
  5. Leé la advertencia de riesgo, marcá I understand and want to continue y seleccioná Create as a plugin.
  6. Iniciá sesión con tu cuenta de Boolfy y revisá las herramientas detectadas.
  7. 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.

Cursor

Agregar a 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.

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.

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:

  1. Agregar un servidor MCP remoto con la URL https://agents.boolfy.com/api/mcp.
  2. Elegir autenticación OAuth (el cliente descubre el servidor de autorización automáticamente).
  3. 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.

Permisos (scopes)
ScopePermite
agents.readLeer agentes, datasets, documentos y proveedores.
agents.documents.writeCargar 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.

HerramientaQué haceTipo
list_agentsLista 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: select, filters, uploaded_from/uploaded_to, process_state (finished | sent | all), document_state (DRAFT | APPROVED | REJECTED | REVISED), order, limit (por defecto 50, máximo 500), offset/cursor.

Operadores: eq, neq, in, not_in, contains, gt, gte, lt, lte, between, is_null, is_not_null.

Los campos de CUIT tienen columnas virtuales <campo>_razon_social, <campo>_condicion_iva y <campo>_code (código ERP), tomadas del maestro de proveedores.

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

ConceptoLímite
query_dataset: registros por página50 por defecto, máximo 500 (paginación con offset o cursor)
list_suppliers: resultados por página50 por defecto, máximo 200 (paginación con cursor)
upload_document: tamaño de archivo10 MB por defecto
upload_document: formatosPDF, imagen, TIFF, Excel
Documentos incluidos en consultasTerminados 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 permiso agents.documents.write.