Contents

Connect a client

Mairies de France is a remote MCP server. Add its address to your AI assistant once, sign in, and the assistant can call the tools during a conversation.

https://mairies.vosfichiers.com/mcp

Every client below signs you in with OAuth: a browser window opens on Mairies de France, you sign in with your email, and you press Allow. No key to copy. If you do not have an account yet, the sign-in creates one.

Menus move from one release to the next. The steps below were checked against each vendor's documentation in November 2026; if a label differs, look for "connectors", "plugins" or "MCP servers" in the settings of your client.

Claude

Works on claude.ai, Claude Desktop and the mobile apps (a connector added on the web follows your account everywhere).

  1. Open Customize, then Connectors.
  2. Click + Add, then Add custom connector.
  3. Enter a name, for example Mairies de France, paste the server address above, and click Continue.
  4. Keep the authentication settings Claude detected, click Continue, then Add.
  5. Sign in to Mairies de France when the browser asks, and press Allow.

In a conversation, click + under the message box, choose Connectors, and switch Mairies de France on.

On Team and Enterprise plans an owner adds the connector first, under Organization settings, Connectors; members then find it under Customize, Connectors and click Connect. The free plan allows one custom connector.

ChatGPT

  1. Open ChatGPT Plugins (chatgpt.com/plugins) in a browser.
  2. Click the + button, then Add custom MCP server.
  3. Enter a name and a description.
  4. Under Connection, choose the public endpoint and paste the server address above, /mcp included.
  5. Leave the authentication on OAuth, read the warning, tick I understand and want to continue, and click Create as a plugin.
  6. Sign in to Mairies de France when asked and press Allow. ChatGPT then lists the tools it found.

In a new conversation, type @ in the message box and pick the plugin. Whether custom MCP servers are offered depends on your ChatGPT plan and, in a workspace, on what its administrator allows. They cannot be added from the mobile apps.

Claude Code

claude mcp add --transport http mairies-de-france https://mairies.vosfichiers.com/mcp

Then run /mcp inside Claude Code, choose the server and follow the sign-in in your browser. Add --scope user to have the server in all your projects.

Cursor

Add the server to ~/.cursor/mcp.json (all projects) or to .cursor/mcp.json in one project:

{
  "mcpServers": {
    "mairies-de-france": {
      "url": "https://mairies.vosfichiers.com/mcp"
    }
  }
}

Open Customize in the Cursor sidebar, find the server in the MCP list and sign in when Cursor asks.

Any other client, with an API key

A client that cannot sign in with OAuth sends an API key instead. Create one under API keys: it is shown once and starts with sk_. Give it to the client as a bearer token:

{
  "mcpServers": {
    "mairies-de-france": {
      "url": "https://mairies.vosfichiers.com/mcp",
      "headers": {
        "Authorization": "Bearer sk_..."
      }
    }
  }
}

With Claude Code:

claude mcp add --transport http mairies-de-france https://mairies.vosfichiers.com/mcp --header "Authorization: Bearer sk_..."

A client that sends an Authorization header does not fall back to OAuth: remove the header to sign in with the browser instead.

What the server expects

For the author of a client:

Transport Streamable HTTP at https://mairies.vosfichiers.com/mcp, stateless, JSON responses
Identity Authorization: Bearer <OAuth access token or API key> on every request
Without identity 401 with a WWW-Authenticate header that points to the protected-resource metadata
OAuth Authorization code with PKCE (S256), one scope: tools. Client ID metadata documents and dynamic registration are both accepted
Redirect addresses HTTPS, or HTTP to localhost, 127.0.0.1 or [::1] on any port
Tokens Access token: one hour. Refresh token: 30 days, replaced at each use

Check that it works

Ask your assistant: "Use Mairies de France to show my account status." It calls the free account-status tool and answers with your plan and your credits.

Disconnect

Connected apps lists the applications you allowed; revoking one stops it at once. A key is revoked under API keys.

If it does not connect

  • The client says the server needs authentication, or shows 401. The sign-in did not finish. Remove the server from the client and add it again.
  • invalid_credential. The key was mistyped or revoked. Create a new one.
  • locked_out. Ten refused credentials from one address within ten minutes block that address for fifteen minutes. Fix the key, then wait.
  • The tools do not show up. Start a new conversation: most clients read the tool list when a conversation starts.