Skip to content

The Open Factura MCP server works with any MCP client. There are two ways to connect it:

  • Remote (HTTP): https://openfactura.co/mcp with the header Authorization: Bearer of_test_…. Nothing to install.
  • Local (stdio): npx -y @openfactura/cli mcp. It uses the key you saved with openfactura login (or the OPENFACTURA_API_KEY and OPENFACTURA_URL variables). Use it for clients that don’t send headers.

While you’re testing, use an of_test_… key: nothing you issue has fiscal value. In test mode there are no saved customers: the agent puts the recipient in datos.receptor. The key decides what the agent can do; see Authentication and keys and the available tools in MCP server.

Ventana de terminal
npx @openfactura/cli login --url https://app.openfactura.co # prompts for the key without echoing it
npx @openfactura/cli mcp install cursor # one agent
npx @openfactura/cli mcp install --todos # every agent it finds on your machine
npx @openfactura/cli mcp install cursor --imprimir # only prints the configuration

Supported agents: claude-code, claude-desktop, cursor, vscode, windsurf, codex, gemini, zed, cline, and goose. npx @openfactura/cli mcp agentes shows which ones it detects on your machine. Before writing, the CLI saves a backup copy of the configuration file, and it never removes the other servers you already have.

Replace of_test_... with your key. After editing a file, restart the agent or reload its MCP servers.

Remote:

Ventana de terminal
claude mcp add --transport http openfactura https://openfactura.co/mcp \
--header "Authorization: Bearer of_test_..."

Local (stdio), with the key from openfactura login:

Ventana de terminal
claude mcp add --transport stdio openfactura -- npx -y @openfactura/cli mcp

Add --scope user to have it in all your projects or --scope project to share it in the repository’s .mcp.json. More details in the Claude Code documentation.

ChatGPT and claude.ai in the browser connect to MCP servers through connectors that require OAuth. The Open Factura server still only accepts API keys; OAuth sign-in is coming soon. In the meantime, use Claude Code, Claude Desktop, Cursor, VS Code, or another agent on this page.

The agent skills teach it to validate before issuing, to confirm with you, and to handle errors:

Ventana de terminal
npx skills add xaviigna/openfactura

For AI assistants: llms.txt ·llms-full.txt ·every page as Markdown by adding .md to its path.