At the root of a repository, for the whole team. Everyone signs in with their own account.
Use an access key instead of OAuth
For a script, CI or a tool without OAuth sign-in. Create a key in Account › MCP connections: it is shown only once. Never paste it into a file under version control.
With an access key
claude mcp add --transport http --scope user factusur https://factusur.com/mcp \
--header "Authorization: Bearer fsk_live_YOUR_KEY"
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.
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.
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.