Doklad.ai

Facturación checa para autónomos y pequeñas empresas: crea, envía y rastrea facturas, clientes, gastos, pagos y flujo de caja desde Claude, ChatGPT, Codex, Cursor o VS Code. Servidor alojado, inicio de sesión con OAuth.

Servidor MCP alojado

npx add-mcp 'https://doklad.ai/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Facturación y contabilidad mediante MCP: doklad.ai en Claude, ChatGPT, Codex y Cursor

Doklad.ai tiene su propio servidor MCP en la dirección https://doklad.ai/mcp.. Lo conecta a Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code o Gemini CLI y luego gestiona facturas, clientes y gastos con una frase normal, por ejemplo: «emite una factura a la empresa Alfa s.r.o. por 12 horas de consultoría a 1 500 Kč». Inicia sesión con su cuenta de doklad.ai mediante OAuth, sin copiar ninguna clave a ningún sitio. El servidor MCP, al igual que todo doklad.ai, es actualmente gratuito, sin límite de facturas y sin tarjeta de pago.

Qué es MCP y por qué afecta a su facturación

Model Context Protocol (MCP) es un estándar abierto mediante el cual el asistente de IA llama a herramientas de otras aplicaciones. Una única interfaz funciona en Claude, ChatGPT, Codex, Cursor, VS Code y otras herramientas, de modo que puede conectar doklad.ai dondequiera que esté trabajando.

Sin MCP, la IA solo le da consejos sobre facturación. Con el servidor MCP de doklad.ai, ella misma lee sus facturas, encuentra al cliente, emite el documento, lo envía por correo electrónico o registra el pago, directamente en su cuenta, con su consentimiento y con registro en el registro de auditoría.

Qué puede hacer la IA mediante doklad.ai

El servidor MCP de doklad.ai ofrece 17 herramientas:

  • Facturas: búsqueda y filtrado (estado, cliente, período), detalle con partidas, emisión, edición, envío por correo electrónico, enlace al PDF, registro de pago y eliminación de borradores.
  • Clientes: búsqueda por nombre, NIF o correo electrónico, detalle, creación y edición.
  • Gastos: lista, detalle y registro de un nuevo gasto.
  • Informes: estadísticas de facturas (pagadas, enviadas, vencidas, borradores) y flujo de caja: ingresos, gastos y beneficio del período seleccionado.

Qué puede escribirle a la IA

  • «¿Qué facturas están vencidas y cuánto me deben en total?»
  • «Emite una factura a la empresa Alfa s.r.o. por 12 horas de consultoría a 1 500 Kč sin IVA, vencimiento a 14 días.»
  • «Envía la factura 2026-0142 al cliente por correo electrónico.»
  • «Ha llegado un pago de 18 150 Kč por la factura 2026-0137, registra el pago con fecha de hoy.»
  • «¿Cuál fue el flujo de caja de septiembre y en qué se diferencia del de agosto?»
  • «Registra un gasto: hosting de septiembre, 990 Kč sin IVA, fecha de hoy.»

La IA organiza los pasos necesarios por sí sola: primero encuentra al cliente y luego emite la factura. Además, doklad.ai le indica que siempre confirme primero con usted el envío de correos electrónicos, el registro de pagos y las eliminaciones.

Dirección del servidor e inicio de sesión

La dirección del servidor MCP es la misma para todas las aplicaciones:

https://doklad.ai/mcp

Inicia sesión con su cuenta de doklad.ai mediante OAuth: la aplicación de IA le redirige a doklad.ai, donde selecciona la empresa y concede el acceso. La aplicación de IA nunca ve la contraseña y no copia ninguna clave a ningún sitio. Para herramientas sin OAuth (n8n, scripts propios) está disponible una clave API.

Claude: claude.ai, Claude Desktop y móvil

  1. En claude.ai abra Customize → Connectors y haga clic en Add custom connector, o use directamente el enlace prellenado.
  2. Como nombre introduzca Doklad.ai, como URL https://doklad.ai/mcp, deje el inicio de sesión en Sign in now y añada el conector.
  3. Se abrirá doklad.ai: inicie sesión, seleccione la empresa y conceda el acceso.
  4. En el chat, active doklad.ai en el menú de herramientas y escriba, por ejemplo, «¿Qué facturas tengo vencidas?».

El conector conectado funciona en la web, en la aplicación Claude Desktop y en la aplicación móvil de Claude. Los conectores personalizados están disponibles en todos los planes de Claude; en el plan Free se permite uno. En los planes Team y Enterprise, el propietario de la organización añade primero el conector en Organization settings → Connectors → Add → Custom → Web y luego los miembros solo se conectan con su cuenta de doklad.ai.

ChatGPT

  1. En ChatGPT en la web, abra Settings → Security and login y active Developer mode.
  2. Abra chatgpt.com/plugins, haga clic en + y rellene el nombre Doklad.ai, una breve descripción y, como conexión (Connection), la dirección https://doklad.ai/mcp con verificación OAuth.
  3. Inicie sesión en doklad.ai, seleccione la empresa y conceda el acceso.
  4. En un chat nuevo, seleccione doklad.ai en el menú de herramientas y escriba normalmente en español.

El modo de desarrollador está disponible en los planes Plus, Pro, Business, Enterprise y Edu en la web de ChatGPT. Antes de una acción que modifique algo (emisión de factura, envío de correo electrónico), ChatGPT pedirá confirmación.

Claude Code

claude mcp add --transport http doklad https://doklad.ai/mcp

Luego, en Claude Code escriba /mcp, seleccione doklad y elija Authenticate: se abrirá el navegador con el inicio de sesión en doklad.ai. El interruptor --scope user hace que doklad.ai esté disponible en todos sus proyectos.

OpenAI Codex (CLI, VS Code, aplicación de escritorio)

codex mcp add doklad --url https://doklad.ai/mcp
codex mcp login doklad

El comando login abre el navegador con el inicio de sesión en doklad.ai. La configuración se guarda en ~/.codex/config.toml, que comparten Codex CLI, la extensión Codex para VS Code y la aplicación de escritorio ChatGPT, por lo que solo necesita añadir doklad.ai una vez. Puede verificar el estado con el comando codex mcp list: en doklad.ai debe aparecer OAuth. Codex está incluido en todos los planes de ChatGPT, incluido el Free.

Cursor

La forma más rápida es con el botón Añadir a Cursor de esta página. Manualmente, en el archivo ~/.cursor/mcp.json (todos los proyectos) o .cursor/mcp.json (un solo proyecto), añada:

{
  "mcpServers": {
    "doklad": {
      "url": "https://doklad.ai/mcp"
    }
  }
}

En Cursor Settings → Tools & MCP, aparecerá una solicitud de inicio de sesión en doklad.ai. Al hacer clic, se abrirá doklad.ai, donde seleccionará la empresa y concederá el acceso.

VS Code con GitHub Copilot

La forma más rápida es con el botón Añadir a VS Code de esta página. Manualmente, en el archivo .vscode/mcp.json del proyecto (o mediante el comando MCP: Add Server), añada:

{
  "servers": {
    "doklad": {
      "type": "http",
      "url": "https://doklad.ai/mcp"
    }
  }
}

Al primer inicio del servidor, VS Code preguntará por el inicio de sesión en doklad.ai. Luego, GitHub Copilot usa las herramientas en el chat en modo Agent. Necesita VS Code 1.99 o superior; en los planes Copilot Business y Enterprise, el administrador de la organización debe habilitar la política MCP servers in Copilot.

Gemini CLI

gemini mcp add --scope user --transport http doklad https://doklad.ai/mcp

Sin --scope user, el servidor solo se añade al proyecto actual. Luego, en Gemini CLI ejecute /mcp auth doklad e inicie sesión en el navegador.

Clave API: n8n, scripts y herramientas sin OAuth

La clave API se crea en doklad.ai en Integraciones → Claves API y webhooks → Servidor MCP. La herramienta de IA la envía en la cabecera Authorization: Bearer dk_…. La clave pertenece a una variable de entorno, no a archivos que comparta o suba al repositorio.

Claude Code:

claude mcp add --transport http doklad https://doklad.ai/mcp --header "Authorization: Bearer $DOKLAD_API_KEY"

Codex (~/.codex/config.toml):

[mcp_servers.doklad]
url = "https://doklad.ai/mcp"
bearer_token_env_var = "DOKLAD_API_KEY"

Claude Desktop mediante el puente mcp-remote (Node.js 20.18 o superior) en claude_desktop_config.json: ábralo en Settings → Developer → Edit Config y, tras la edición, cierre la aplicación por completo y vuelva a iniciarla. El espacio después de Bearer pertenece a la variable, no al argumento; de lo contrario, Claude Desktop lo dividirá en Windows:

{
  "mcpServers": {
    "doklad": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://doklad.ai/mcp", "--header", "Authorization:${DOKLAD_AUTH_HEADER}"],
      "env": { "DOKLAD_AUTH_HEADER": "Bearer dk_VAS_KLIC" }
    }
  }
}

En n8n, use el nodo MCP Client Tool: Endpoint https://doklad.ai/mcp, Server Transport HTTP Streamable, Authentication Bearer Auth con la clave dk_….

Seguridad y control de los datos

  • OAuth 2.1 con PKCE. La aplicación de IA nunca ve su contraseña. Recibe un token para una sola empresa, que dura una hora y se renueva periódicamente.
  • Consentimiento con selección de empresa. En la página de doklad.ai ve qué aplicación solicita el acceso y adónde le devolveremos tras concederlo. Solo el propietario o administrador de la empresa puede conectar la IA.
  • Revocación con un clic. Todas las conexiones se encuentran en Integraciones → Claves API y webhooks → Aplicaciones conectadas.
  • Registro de auditoría. Cada llamada a una herramienta se registra en el registro de auditoría de la empresa.
  • Precaución en las intervenciones. Las herramientas que modifican algo o envían datos externamente están marcadas en MCP y las aplicaciones de IA, por defecto, solo las ejecutan tras su confirmación. Solo se puede eliminar un borrador o una factura anulada.
  • Límite de solicitudes. Máximo 60 llamadas por minuto por empresa, de modo que una IA en bucle no pueda causar daños.
  • Huellas en lugar de secretos. Los tokens y las claves API no se almacenan en la base de datos en formato legible, solo su huella.

¿Facturación o contabilidad?

Doklad.ai cubre la facturación, el registro de gastos, el emparejamiento de pagos y los informes para autónomos y pequeñas empresas. La contabilidad por partida doble y las declaraciones de impuestos las sigue llevando el contable: usted le entrega los documentos mediante exportación, por ejemplo a Pohoda o Money S3. Así, mediante MCP, la IA prepara y revisa los documentos para la contabilidad, no el cierre contable. Puede encontrar un contable que sepa trabajar con doklad.ai en el catálogo de contables.

Cuánto cuesta

El servidor MCP, al igual que todo doklad.ai, es actualmente gratuito, sin límite de facturas y sin tarjeta de pago. La suscripción de la propia aplicación de IA (Claude, ChatGPT, Cursor…) se paga a su proveedor; algunas aplicaciones ofrecen conectores propios solo en planes de pago. Cómo se compara doklad.ai con Fakturoid, Fakturujsi.cz, Taxorio y otros se muestra en la comparación de servidores MCP para facturación.

Preguntas frecuentes

¿Qué es el servidor MCP de doklad.ai?

Una interfaz según el estándar abierto Model Context Protocol en la dirección https://doklad.ai/mcp.. A través de ella, asistentes de IA como Claude, ChatGPT, Codex o Cursor leen y gestionan sus facturas, clientes y gastos en doklad.ai.

¿Necesito una clave API para conectarme?

No. Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code y Gemini CLI inician sesión con la cuenta de doklad.ai mediante OAuth. La clave API es solo para herramientas sin OAuth, por ejemplo n8n o scripts propios.

¿Puede la IA enviar o eliminar una factura sin que yo lo sepa?

Las herramientas que modifican algo o envían datos externamente están marcadas en MCP y las aplicaciones de IA, por defecto, solo las ejecutan tras su confirmación. Solo se puede eliminar un borrador o una factura anulada, y cada llamada se registra en el registro de auditoría de la empresa.

¿A qué empresa se conecta la IA?

A la que seleccione al conceder el acceso. El acceso es válido para una sola empresa; para otra empresa, cancele la conexión y vuelva a conectarse.

¿Cómo cancelo el acceso de la IA?

En doklad.ai, en Integraciones → Claves API y webhooks → Aplicaciones conectadas, o eliminando el conector directamente en la aplicación de IA.

¿Cuánto cuesta el servidor MCP de doklad.ai?

El servidor MCP, al igual que todo doklad.ai, es actualmente gratuito, sin límite de facturas y sin tarjeta de pago. La suscripción de la propia aplicación de IA (Claude, ChatGPT, Cursor…) se paga a su proveedor; algunas aplicaciones ofrecen conectores propios solo en planes de pago.

¿Doklad.ai también lleva la contabilidad mediante MCP?

Doklad.ai cubre la facturación, los gastos, el emparejamiento de pagos y los informes. La contabilidad por partida doble la lleva el contable; usted le entrega los documentos mediante exportación (por ejemplo, a Pohoda o Money S3). Así, la IA mediante MCP prepara los documentos para la contabilidad, no el cierre contable.

¿Funciona con datos de Fakturoid o iDoklad?

El servidor MCP trabaja con los datos de doklad.ai. Desde Fakturoid e iDoklad puede transferirlos con el asistente en Integraciones → Importación de datos: se transfieren clientes, facturas con partidas y PDF, y gastos.