Servidor MCP

El servidor MCP de FacturaDirecta conecta tu asistente de IA con tu cuenta. Una vez conectado, puedes preguntarle por tus facturas, presupuestos, gastos, contactos, productos, contabilidad o impuestos en lenguaje natural, y él consulta tus datos reales para responderte. También puedes pedirle que cree facturas, registre cobros o envíe documentos: te enseña lo que va a hacer y te pide confirmación antes.

MCP (Model Context Protocol) es el estándar abierto con el que los asistentes de IA se conectan a otras aplicaciones. Nuestro servidor es remoto: no hay nada que instalar.

Antes de empezar#

• Una cuenta de FacturaDirecta. Sirve cualquier plan, también el Gratis.
• Un asistente compatible con servidores MCP remotos: Claude, ChatGPT, Codex, Cursor, VS Code y muchos otros.
• Nada más. No hacen falta API keys ni client ID: inicias sesión con tu usuario de FacturaDirecta y eliges qué permisos das.

Conecta tu asistente#

Todos los clientes usan la misma URL: https://mcp.facturadirecta.com.

Claude#

En claude.ai, la aplicación de escritorio y la móvil:

1. Abre Ajustes → Conectores y pulsa Añadir conector personalizado (o usa el botón Añadir a Claude de esta página).
2. Pega la URL https://mcp.facturadirecta.com. No hay que rellenar client ID ni secreto.
3. Pulsa Añadir y después Conectar. FacturaDirecta te muestra qué aplicación pide acceso y con qué permisos.
4. Inicia sesión con tu usuario de FacturaDirecta y autoriza el acceso. Listo.

En los planes Team y Enterprise de Claude puede que tenga que añadir el conector un administrador de la organización.

Claude Code#

claude mcp add --transport http facturadirecta https://mcp.facturadirecta.com

Después, dentro de Claude Code, escribe /mcp, elige facturadirecta e inicia sesión.

ChatGPT#

1. En Ajustes → Seguridad e inicio de sesión, activa el modo desarrollador.
2. En Ajustes → Plugins, pulsa + y pega la URL https://mcp.facturadirecta.com.
3. Inicia sesión con tu usuario de FacturaDirecta y autoriza el acceso.

Disponible en los planes de ChatGPT que permiten conectores personalizados (Plus, Pro, Business, Enterprise y Edu).

Codex#

Codex CLI, la extensión de IDE y la aplicación de escritorio de ChatGPT comparten configuración:

codex mcp add facturadirecta --url https://mcp.facturadirecta.com
codex mcp login facturadirecta

Cursor, VS Code y otros clientes#

Añade un servidor MCP remoto con la URL. El cliente se registra solo y te pide iniciar sesión. En Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "facturadirecta": { "url": "https://mcp.facturadirecta.com" }
  }
}

En VS Code (.vscode/mcp.json):

{
  "servers": {
    "facturadirecta": { "type": "http", "url": "https://mcp.facturadirecta.com" }
  }
}

Tú decides qué puede hacer#

• Actúa con tu usuario. El asistente ve las empresas y los datos a los que tú tienes acceso en FacturaDirecta, nunca más.
• Permisos explícitos. Al conectar, FacturaDirecta te enseña qué aplicación pide acceso, a dónde vuelve la autorización y qué permisos solicita.
• Consulta o modificación, siempre declarado. Cada herramienta indica si solo consulta datos o si puede cambiarlos. Los asistentes piden tu confirmación antes de usar las que modifican algo.
• Varias empresas. Si trabajas con más de una, el asistente te preguntará con cuál hacerlo; el servidor no guarda ninguna empresa activa.
• Desconexión. Puedes desconectarlo cuando quieras desde los ajustes de conectores de tu asistente.

Tratamiento de datos#

• El servidor no guarda tus datos: consulta FacturaDirecta en el momento y devuelve el resultado a tu asistente.
• No lee tus conversaciones: solo recibe los parámetros de cada consulta.
• Por seguridad registramos qué herramienta se usa y sus filtros (fechas, estados, paginación). Nunca registramos tus credenciales, textos libres ni importes.
• Más detalles en la política de privacidad.

Problemas frecuentes#

El asistente no ve ninguna herramienta. Comprueba que completaste el inicio de sesión y autorizaste el acceso. Si no, desconecta el conector y vuelve a conectarlo.

Trabaja con la empresa que no es. Dile en la conversación con qué empresa quieres trabajar; también puedes preguntarle qué empresas ve.

Mi cliente solo admite tokens fijos. Algunos diálogos de “MCP personalizado” solo aceptan cabeceras o tokens estáticos y no OAuth. En ese caso usa la línea de comandos del cliente (por ejemplo codex mcp add) o el CLI de FacturaDirecta con una API key.

Detalles técnicos#

• URL: https://mcp.facturadirecta.com (también responde en /mcp).
• Transporte: Streamable HTTP sin estado. Compatible con la especificación MCP 2026-07-28 y con los clientes que aún usan las versiones de 2025.
• Autorización: OAuth 2.1 con PKCE S256, registro dinámico de clientes y documentos de metadatos de cliente (CIMD). Metadatos del recurso en /.well-known/oauth-protected-resource.
• Catálogo en JSON: https://mcp.facturadirecta.com/tools.json, sin autenticación: cada herramienta con su resumen, su estado, sus permisos y su esquema de entrada.
• Herramientas: una de consulta por área (facturas, presupuestos, compras, bancos, impuestos…) y otra de escritura en las que admiten cambios, más la búsqueda, la consulta analítica, la lectura de documentos y la subida de ficheros. Cada herramienta de área expone sus acciones, cada una con su operación de la API: consulta la referencia de herramientas.