Install guide
Connect Normi to your AI client: paste a URL, sign in, approve. Or use an API key.
Guides by client
The exact configuration, a first prompt with its real response, and troubleshooting specific to each client:
Choose the method
| Client | Method |
|---|---|
| claude.ai (web, mobile, Cowork), Claude Desktop | One click from the Claude directory, then OAuth sign-in |
| ChatGPT | OAuth sign-in |
| Claude Code | OAuth sign-in (/mcp), or an API key |
| Cursor, VS Code (Copilot), Windsurf, Gemini CLI | OAuth sign-in, or an API key |
| n8n, LangChain / LangGraph, REST API, scripts, CI | A normi_… API key |
With OAuth you don't need to create a key in advance: if your account doesn't have one, a free key (500 credits) is created on your first approval. Either way, credits are charged to your account's active key. Learn more
Connect your client
claude.ai, Claude Desktop, mobile, Cowork Recommended
Normi is in the Claude connector directory: open the listing, click to add it, then sign in to Normi and approve Claude. No URL to paste.
Directory not available in your organisation? Add a custom connector with this URL:
https://mcp.normi.fr/mcp
ChatGPT
- In ChatGPT: Plugins → Add → Create an MCP app.
- Any name (if “Normi” is already taken, use for example “Normi-mcp”), the URL below, OAuth authentication, then Create.
- Sign in to Normi and approve ChatGPT.
https://mcp.normi.fr/mcp
What is the median price per m² for apartments in Lyon 6?
Claude Code
Add the server, then run /mcp inside Claude Code to sign in:
claude mcp add --transport http normi https://mcp.normi.fr/mcp # then, inside Claude Code: /mcp
Without a browser (CI, remote machine), with an API key:
claude mcp add --transport http normi https://mcp.normi.fr/mcp --header "Authorization: Bearer YOUR_TOKEN"
API key (REST, scripts, n8n, STDIO)
- Sign in on normi.fr with Google.
- In the dashboard, go to Tokens → Create a token.
- Copy the token shown — it won't be visible again.
Claude Desktop with a key, through the STDIO package @normi/mcp-dvf:
{
"mcpServers": {
"normi": {
"command": "npx",
"args": ["-y", "@normi/mcp-dvf"],
"env": { "NORMI_API_KEY": "normi_YOUR_TOKEN" }
}
}
}Clients with neither OAuth nor custom headers: a secret connector URL is available in Dashboard → Tokens → AI connectors (Advanced section).
HTTP Streamable (universal)
For any MCP client that supports HTTP Streamable (Cline, custom agents…):
| URL | https://mcp.normi.fr/mcp |
| Transport | HTTP Streamable (POST) |
| Auth | OAuth 2.1 (discovered via 401 + WWW-Authenticate), or Authorization: Bearer YOUR_TOKEN |
Ask This Guy Partner platform
Ask This Guy is a conversational AI platform that integrates Normi natively in its MCP catalogue. Your users can query DVF data directly from their conversations.
- Sign in to your Ask This Guy console.
- Go to Tools management → MCP Catalog.
- Select Normi and enter your API key (
normi_…). - Normi is immediately available in your conversations.
Check that it works
In Claude or ChatGPT, ask a question about French property prices:
Claude calls the Normi tools automatically and answers with real DVF data.