> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockgence.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectarse al MCP

> Conectá tu asistente de IA a Blockgence con una URL y tu clave, o con login por OAuth.

El servidor MCP de Blockgence deja que tu asistente de IA investigue on-chain desde el chat: «¿esta wallet es riesgosa?»,
«seguí la plata de este hacker», «¿este contrato es un honeypot?». Funciona con cualquier cliente que hable
[MCP](https://modelcontextprotocol.io) por HTTP: Claude Code, Claude Desktop, claude.ai, Cursor, Codex y otros.

Cada herramienta consulta la API con **tu** cuenta: ve tus labels y consume tu cupo, igual que la web. El servidor no
guarda ninguna clave propia.

## Lo que necesitás

**1. La URL**

```
https://mcp.blockgence.com/mcp
```

**2. Tu clave**

En [app.blockgence.com](https://app.blockgence.com), menú de tu nombre → **MCP…** → *Crear clave*. Se muestra una
sola vez: copiala en ese momento. Podés tener hasta 5, una por cliente o por máquina, y revocar cualquiera al
instante. Ver [Claves de API](https://docs.blockgence.com/es/get-started/api-keys.md).

**3. Configurá tu cliente**

La clave va en cada pedido, en el header `Authorization: Bearer bkg_live_…`. En **MCP…** hay un bloque listo para
pegar en cada cliente, con la URL y tu clave ya puestas.

## Configuración por cliente

> [tab] Claude Code
>
> ```bash theme={null}
> claude mcp add --transport http blockgence https://mcp.blockgence.com/mcp \
>   --header "Authorization: Bearer bkg_live_…"
> ```

> [tab] Cursor
>
> En `~/.cursor/mcp.json` (o Settings → MCP):
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "blockgence": {
>       "url": "https://mcp.blockgence.com/mcp",
>       "headers": { "Authorization": "Bearer bkg_live_…" }
>     }
>   }
> }
> ```

> [tab] Codex
>
> En `~/.codex/config.toml`:
>
> ```toml theme={null}
> [mcp_servers.blockgence]
> url = "https://mcp.blockgence.com/mcp"
> http_headers = { Authorization = "Bearer bkg_live_…" }
> ```

> [tab] Claude Desktop
>
> En `~/Library/Application Support/Claude/claude_desktop_config.json`. Usa
> [`mcp-remote`](https://www.npmjs.com/package/mcp-remote), así que hace falta Node:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "blockgence": {
>       "command": "npx",
>       "args": ["-y", "mcp-remote", "https://mcp.blockgence.com/mcp",
>                "--header", "Authorization:${BLOCKGENCE_AUTH}"],
>       "env": { "BLOCKGENCE_AUTH": "Bearer bkg_live_…" }
>     }
>   }
> }
> ```

Reiniciá tu cliente: aparecen las herramientas de Blockgence. Ver la [lista de herramientas](https://docs.blockgence.com/es/mcp/tools.md).

## claude.ai y otros conectores con login

Con un cliente que soporta OAuth, no pegás ninguna clave. En claude.ai: **Ajustes → Conectores → Añadir conector
personalizado**, con el nombre «blockgence» y la URL `https://mcp.blockgence.com/mcp`.

**1. El cliente se registra solo**

Descubre el servidor de autorización de Blockgence y se registra sin que hagas nada.

**2. Iniciás sesión y aprobás**

Te manda a Blockgence: entrás como siempre (también con Google, si está habilitado) y aprobás. La pantalla dice qué
aplicación pide acceso y **a dónde vuelve el navegador**.

**3. Listo**

La aplicación obtiene una clave tuya que vence al día y que renueva sola. Consume de tu cuenta y tu plan.

> [!WARNING]
>
> Si no empezaste vos esa conexión, rechazala. Las aplicaciones conectadas se ven y se desconectan en **MCP… →
> Aplicaciones conectadas**; desconectar revoca la conexión y todas sus claves al instante.

## Si algo falla

| Lo que ves | Qué pasa | Qué hacer |
| - | - | - |
| «No autorizado» (`401`) al conectar | Falta la clave o se revocó. | Creá otra en **MCP…** y actualizá la configuración. |
| `503` al conectar | La API de Blockgence no responde. Es reintentable y no significa que la clave sea inválida. | Reintentá en unos minutos. |
| Una herramienta devuelve `source_unavailable` | La fuente de datos falló al leer lo que pediste. No se cobró. | Reintentá si `retryable` es `true`; si no, la consulta no se puede hacer con esa red o fuente. |

Las herramientas siguen las mismas reglas que la API para las fallas y los cortes: una falla nunca es «sin datos», y un
resultado parcial trae `degraded_sources`. Ver [Errores](https://docs.blockgence.com/es/api/errors.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.