Servidor MCP

Conecta Claude Desktop, Claude Code, Cursor o cualquier cliente MCP a findbytown con tu clave API.

El Model Context Protocol permite que un asistente llame a herramientas externas. Conectado a findbytown, un asistente como Claude puede buscar empresas, consultar tu cuota y, cuando lo aceptas, revelar contactos.

• Dirección: https://findbytown.com/api/mcp, también accesible en https://developers.findbytown.com/api/mcp.
• Transporte: Streamable HTTP, sin estado, con respuestas JSON. No hay sesiones ni flujo de eventos, y GET y DELETE responden 405.
• Autenticación: tu clave API como token Bearer.
• Límites: las mismas claves, comprobación de plan, cuota y límites que la API REST.

Consulta cada herramienta. Sustituye la clave de ejemplo por la tuya: tu página de claves API muestra estos mismos bloques con una clave nueva ya incluida.

Claude Code

Ejecuta esto una vez en tu terminal:

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

Para compartir la configuración con un proyecto sin compartir la clave, pon esto en .mcp.json en la raíz del proyecto y define FINDBYTOWN_API_KEY en tu entorno. Claude Code pide aprobación antes de usar el servidor de un proyecto.

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

Claude Desktop

Añádelo como conector personalizado, si tu plan los ofrece:

1. Ve a Customize > Connectors, selecciona + Add y luego Add custom connector.
2. Nombre: findbytown. URL del servidor MCP remoto: https://findbytown.com/api/mcp.
3. En Request headers, añade Authorization con el valor Bearer seguido de un espacio y tu clave.
4. Selecciona Add.

En los planes Team y Enterprise, un Owner añade el conector en la configuración de la organización. Los conectores nos llegan desde los servidores de Anthropic, no desde tu ordenador.

También puedes usar el archivo de configuración con el puente mcp-remote, que necesita Node.js. Añade esto a claude_desktop_config.json (en macOS en ~/Library/Application Support/Claude/, en Windows en %APPDATA%\Claude\) y reinicia 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

Pon esto en ~/.cursor/mcp.json para todos los proyectos, o en .cursor/mcp.json para uno solo. Para que la clave no esté en el archivo, escribe Bearer ${env:FINDBYTOWN_API_KEY} en su lugar y define esa variable en tu entorno.

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

Otros clientes

Funciona cualquier cliente que hable Streamable HTTP y pueda enviar una cabecera. Necesita la dirección, Authorization: Bearer <key> y Accept: application/json, text/event-stream en cada POST. Para comprobar la conexión a mano:

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"}'

Seguridad

• La configuración de tu cliente contiene tu clave, así que trata ese archivo como una contraseña.
• reveal_company solo gasta cuota con confirm: true, y así lo indica a los clientes. Mantén activada la solicitud de aprobación de tu cliente para esta herramienta.
• Los nombres y las descripciones de las empresas los escriben terceros. Los resultados se marcan como datos no fiables y se limpian de caracteres de control, pero un modelo aún puede dejarse engañar por el texto que lee: revísalo antes de actuar.
• Un navegador solo puede llamar desde nuestros propios sitios: cualquier otro Origin recibe un 403.

Volver a findbytown