# Servidor MCP > Conecta Claude, ChatGPT, Codex, Cursor o cualquier asistente compatible con MCP a tu cuenta de FacturaDirecta con una sola URL. Consulta facturas, gastos y contabilidad en lenguaje natural. 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 o en la aplicación de escritorio: 1. Usa el botón *Añadir a Claude* de esta página, o abre los conectores de Claude (*Customize → Connectors* en la interfaz en inglés), pulsa **+** y elige añadir un conector personalizado. 2. Pega la URL `https://mcp.facturadirecta.com`. No hay que rellenar client ID ni secreto: deja la autenticación que propone Claude. 3. Añade el conector y conéctalo. FacturaDirecta te muestra qué aplicación pide acceso y con qué permisos. 4. Inicia sesión con tu usuario de FacturaDirecta, elige las empresas y los permisos, y autoriza el acceso. En los planes Team y Enterprise de Claude, el conector lo añade un propietario en la configuración de la organización; después cada persona lo conecta con su propio usuario. El plan Free de Claude admite un solo conector personalizado. ### Claude Code ```shell 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 la web de ChatGPT, abre la página de plugins (`chatgpt.com/plugins`), pulsa **+** y elige añadir un servidor MCP personalizado. 2. Pega la URL `https://mcp.facturadirecta.com` y elige OAuth como autenticación. 3. Acepta el aviso sobre los servidores personalizados, crea el plugin, inicia sesión con tu usuario de FacturaDirecta y autoriza el acceso. Si ChatGPT no te ofrece la opción, puede que antes tengas que activar el modo desarrollador en sus ajustes. 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: ```shell 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`): ```json { "mcpServers": { "facturadirecta": { "url": "https://mcp.facturadirecta.com" } } } ``` En VS Code (`.vscode/mcp.json`): ```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.** En **Aplicaciones conectadas**, desde el menú de tu perfil en FacturaDirecta, le retiras el acceso al momento. También puedes quitar el conector en los ajustes 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](https://www.facturadirecta.com/legal/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](https://www.facturadirecta.com/desarrolladores/cli/) 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`](https://mcp.facturadirecta.com/.well-known/oauth-protected-resource). - **Catálogo en JSON:** [`https://mcp.facturadirecta.com/tools.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](https://www.facturadirecta.com/desarrolladores/mcp/herramientas/).