Serveur MCP

Connectez Claude Desktop, Claude Code, Cursor ou tout client MCP à findbytown avec votre clé API.

Le Model Context Protocol permet à un assistant d’appeler des outils externes. Connecté à findbytown, un assistant comme Claude peut chercher des entreprises, vérifier votre quota et, avec votre accord, révéler des contacts.

• Adresse : https://findbytown.com/api/mcp, également accessible à https://developers.findbytown.com/api/mcp.
• Transport : Streamable HTTP, sans état, avec des réponses JSON. Il n’y a ni sessions ni flux d’événements, et GET et DELETE répondent 405.
• Authentification : votre clé API sous forme de jeton Bearer.
• Limites : les mêmes clés, la même vérification d’offre, le même quota et les mêmes limites que l’API REST.

Voir chaque outil. Remplacez la clé d’exemple par la vôtre : votre page Clés API affiche ces mêmes extraits avec une nouvelle clé déjà renseignée.

Claude Code

Exécutez ceci une fois dans votre terminal :

claude mcp add --transport http findbytown https://findbytown.com/api/mcp \
  --header "Authorization: Bearer fbt_EXAMPLE_not_a_real_key_0000"

Pour partager la configuration avec un projet sans partager la clé, placez ceci dans .mcp.json à la racine du projet, et définissez FINDBYTOWN_API_KEY dans votre environnement. Claude Code demande une approbation avant d’utiliser le serveur d’un projet.

{
  "mcpServers": {
    "findbytown": {
      "type": "http",
      "url": "https://findbytown.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${FINDBYTOWN_API_KEY}"
      }
    }
  }
}

Claude Desktop

Ajoutez-le comme connecteur personnalisé, si votre offre en propose :

1. Allez dans Customize > Connectors, sélectionnez + Add, puis Add custom connector.
2. Champ Name : findbytown. Champ Remote MCP server URL : https://findbytown.com/api/mcp.
3. Sous Request headers, ajoutez Authorization avec pour valeur Bearer suivi d’une espace et de votre clé.
4. Sélectionnez Add.

Sur les offres Team et Enterprise, un Owner ajoute le connecteur dans les paramètres de l’organisation. Les connecteurs nous contactent depuis les serveurs d’Anthropic, et non depuis votre ordinateur.

Ou utilisez le fichier de configuration avec la passerelle mcp-remote, qui nécessite Node.js. Ajoutez ceci à claude_desktop_config.json (sur macOS dans ~/Library/Application Support/Claude/, sur Windows dans %APPDATA%\Claude\) et redémarrez Claude Desktop :

{
  "mcpServers": {
    "findbytown": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://findbytown.com/api/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer fbt_EXAMPLE_not_a_real_key_0000"
      }
    }
  }
}

Cursor

Placez ceci dans ~/.cursor/mcp.json pour tous les projets, ou dans .cursor/mcp.json pour un seul. Pour garder la clé hors du fichier, écrivez plutôt Bearer ${env:FINDBYTOWN_API_KEY} et définissez cette variable dans votre environnement.

{
  "mcpServers": {
    "findbytown": {
      "url": "https://findbytown.com/api/mcp",
      "headers": {
        "Authorization": "Bearer fbt_EXAMPLE_not_a_real_key_0000"
      }
    }
  }
}

Autres clients

Tout client qui parle Streamable HTTP et peut envoyer un en-tête fonctionne. Il lui faut l’adresse, Authorization: Bearer <key> et Accept: application/json, text/event-stream à chaque POST. Pour vérifier la connexion à la main :

curl -X POST "https://findbytown.com/api/mcp" \
  -H "Authorization: Bearer fbt_EXAMPLE_not_a_real_key_0000" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Sécurité

• La configuration de votre client contient votre clé : traitez ce fichier comme un mot de passe.
• reveal_company ne consomme du quota qu’avec confirm: true, et le signale aux clients. Gardez la demande d’approbation de votre client activée pour cet outil.
• Les noms et descriptions d’entreprises sont rédigés par des tiers. Les résultats sont marqués comme données non fiables et nettoyés des caractères de contrôle, mais un modèle peut quand même être induit en erreur par un texte qu’il lit : vérifiez avant d’agir.
• Un navigateur ne peut appeler que depuis nos propres sites : toute autre valeur Origin reçoit un 403.

Retour à findbytown