Skip to content
Factusur

Setup guide · Claude Desktop and claude.ai

Add Factusur to Claude Desktop and claude.ai

Add Factusur as a custom connector in Claude, allow access, then convert your invoices to Factur-X right in a conversation.

Install Factusur in Claude Desktop and claude.ai

Factusur is added as a custom connector, with no configuration file.

  1. Step 1: In Claude (desktop app or claude.ai), open “Customize” › “Connectors”, then “Add custom connector”.
  2. Step 2: Name it “Factusur”, paste the URL https://factusur.com/mcp, then click “Add”.
  3. Step 3: Click “Connect”: the Factusur page opens; sign in and allow access.
  4. Step 4: In a conversation, turn on the Factusur connector and attach your invoice.
Connector URL
https://factusur.com/mcp

Sign-in: OAuth only (Claude presents its published identity; no key to copy). Source: Claude documentation: custom connectors (opens in a new tab), checked on 26 October 2026.

What to ask Claude Desktop and claude.ai

convert_to_facturxConvertcounts one conversion

Convert an invoice

PDF, photo or structured data → Factur-X EN 16931, with a check report and a download link. If a mandatory detail is missing, the agent asks you for it.

  • “Convert invoice-042.pdf to Factur-X with Factusur.”
  • “Create a Factur-X for this invoice: 3 days of consulting at €450 excl. VAT, customer Exemple SAS.”
validate_facturxValidatecounts nothing

Check a Factur-X

Checks PDF/A-3, XML, XSD, the EN 16931 schematron and the French mandatory details of a Factur-X you received. Counts no conversion.

  • “Check the Factur-X my supplier sent me and tell me what’s wrong.”
get_usageReadcounts nothing

Quota and plan

Conversions used and left, reset date, safety caps.

  • “How many conversions do I have left this month?”
All MCP server tools

Troubleshooting

“401” or “authentication required”

Sign in again from your tool (/mcp in Claude Code, “Connect” in Cursor, codex mcp login). A revoked or expired key must be replaced.

“quota_exceeded”

Your monthly quota is used up: open the link shown by the agent to change plan or add a pack, then ask the agent to resume the conversion (nothing is read again).

“needs_input”: missing details

The invoice lacks some mandatory details (customer SIREN, date…). Give them to the agent: it fixes them with update_conversion, then runs the conversion again.

“rate_limited”

A safety cap was reached (calls per minute, conversions per day). Wait a moment, or adjust your caps in Account › MCP connections.

File too large

Above 3 MB, the agent must use create_upload_url (direct upload, 10 MB at most). A PDF of more than 10 pages is refused: upload the invoice only.

My tool can’t find the server

Check the exact URL https://factusur.com/mcp and the “http” transport (Streamable HTTP). Older clients limited to the SSE transport are not supported.

Access, data and payment: MCP server security.

Factusur is not an approved platform (plateforme agréée, PA) and does not transmit your invoices. We create a file in Factur-X format from the information you confirm.