# FlashData MCP

Dale a tu agente acceso a Google Search y YouTube. Conecta tu aplicación y pídele su primer resultado.

Referencia canónica: https://flashdata.dev/es/docs/integrations/mcp-clients
Revisado: 2026-11-05 por FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-mcp) — Servidor MCP oficial
- [Referencia de MCP](https://flashdata.dev/es/docs/mcp/reference.md) — Herramientas, parámetros y respuestas
- [Obtén una clave API](https://flashdata.dev/app/api-keys) — Para clientes que se autentican mediante cabeceras

<a id="connect"></a>

## 1. Conecta e inicia sesión

Elige Codex u OpenClaw para iniciar sesión con OAuth en el navegador. Para otros clientes, elige Remoto / clave API si admiten Streamable HTTP y cabeceras personalizadas, o Local / stdio si ejecutan procesos MCP. El servidor remoto no requiere instalación local.

### Codex

Añade esta configuración a ~/.codex/config.toml y ejecuta el comando de inicio de sesión. Crea una cuenta de FlashData o inicia sesión y autoriza el acceso en el navegador. Después, abre una nueva sesión de Codex.

#### config.toml

```toml
[mcp_servers.flashdata]
url = "https://data.flashdata.dev/mcp"

[mcp_servers.flashdata.oauth]
client_id = "flashdata-codex"
callback_url = "http://127.0.0.1/callback"
```

#### Iniciar sesión

```bash
codex mcp login flashdata --scopes mcp:research
```


### OpenClaw

Ejecuta estos comandos en Bash o PowerShell 7, en el perfil de OpenClaw que usa tu agente. Crea una cuenta o inicia sesión y autoriza el acceso en el navegador. Después, abre una nueva sesión. El comando doctor con --probe comprueba la conexión guardada.

#### Configurar y conectar

```bash
openclaw mcp set flashdata '{"url":"https://data.flashdata.dev/mcp","transport":"streamable-http","auth":"oauth","oauth":{"scope":"mcp:research","clientMetadataUrl":"https://api.flashdata.dev/oauth/clients/openclaw.json"}}'
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probe
```


### Remoto / clave API

Crea una clave con permiso para Google Search o reutiliza una que ya lo tenga. Añade un servidor en la configuración MCP de tu cliente con estos campos. Introduce la clave en el campo protegido de la cabecera y vuelve a conectar. No necesitas ejecutar un comando de OAuth.

#### Configuración del servidor

```text
Name: flashdata
Transport: Streamable HTTP
URL: https://data.flashdata.dev/mcp
Header: X-API-Key: YOUR_API_KEY
```

- [Crear una clave API](https://flashdata.dev/app/api-keys)

### Local / stdio

Necesitas Node.js 22.18+ y una clave API con permiso para Google Search. Añade este bloque a un cliente compatible con la configuración JSON mcpServers. Sustituye YOUR_API_KEY en su configuración local protegida y reinicia el cliente. En Windows, usa npx.cmd si el cliente requiere el nombre del archivo ejecutable.

El paquete npm de la versión indicada ejecuta el servidor MCP local. La CLI independiente de FlashData es un ejecutable distinto.

#### Configuración MCP

```json
{
  "mcpServers": {
    "flashdata": {
      "command": "npx",
      "args": [
        "--yes",
        "--package=@flashdata-dev/mcp@0.2.0",
        "flashdata-mcp"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

- [Crear una clave API](https://flashdata.dev/app/api-keys)
- [Documentación del servidor local](https://github.com/flashdatadev/flashdata-mcp)


<a id="sign-in"></a>

## 2. Comprueba la conexión

Envía este mensaje en una nueva sesión del agente. Las llamadas a get_pricing y get_balance deben completarse sin errores y mostrar el precio de google_search y tu saldo disponible. Un saldo de cero indica que necesitas créditos para buscar, no que haya fallado la autenticación.

### Comprobar la conexión

```text
Usa la conexión MCP flashdata existente.
Llama a get_pricing con {"source":"google_search","request_count":1}.
Llama a get_balance con {}.
Indica si ambas llamadas se completaron sin errores, si la fuente tiene un precio
disponible y cuál es el saldo de créditos. Un saldo de cero no es un fallo de autenticación.
No ejecutes búsquedas ni descargas. No crees pruebas ni cambies credenciales.
```


<a id="task"></a>

## 3. Pide tu primera tarea

Pega este mensaje en tu agente ya conectado. Consultar el saldo y los precios es gratis; la búsqueda consume créditos de la cuenta.

### Primera tarea

```text
Usa FlashData para consultar mi saldo y el precio de una búsqueda de Google. Si hay créditos suficientes, llama a google_search una sola vez con query "battery recycling research", num 5 y mode "realtime". Devuelve los títulos, las URL de las fuentes, extractos breves y los créditos realmente utilizados. Detente al terminar esta tarea.
```


<a id="result"></a>

### Comprueba el resultado

El agente debe devolver enlaces a las fuentes, extractos y los créditos realmente utilizados. La respuesta de búsqueda contiene status: done y results[].organic. Un resultado vacío también es válido: el agente debe indicarlo. La respuesta siguiente es un ejemplo ilustrativo.

#### Ejemplo de respuesta

```text
Se completó una búsqueda de Google.
1. Investigación sobre el reciclaje de baterías — https://example.org/recycling
   Un extracto de búsqueda de ejemplo.
Créditos utilizados: 0.02
```


<a id="tools"></a>

## Herramientas disponibles

Las llamadas con clave API usan los permisos de esa clave. Consulta las herramientas y los esquemas de entrada del servidor para conocer el catálogo completo disponible.

| Tarea | Herramienta | Acceso |
| --- | --- | --- |
| Buscar en Google | google_search | mcp:research / API key |
| Buscar vídeos en YouTube | youtube_search | mcp:research / API key |
| Leer metadatos de vídeo | youtube_metadata | mcp:research / API key |
| Obtener subtítulos existentes | youtube_transcript | mcp:research / API key |
| Descargar vídeo o audio | youtube_download | Clave API del titular + almacenamiento de destino |
| Consultar la cuenta y los precios | get_balance, get_pricing, get_limits, get_usage | Consultas de cuenta gratuitas |

- [Todas las herramientas y parámetros](https://flashdata.dev/es/docs/mcp/reference.md#parameters)
- [Configurar descargas](https://flashdata.dev/es/docs/guides/youtube-download-guide/reference.md)

<a id="authentication"></a>

## OAuth, permisos y pruebas

OAuth conecta la cuenta verificada del titular y permite que el cliente guarde y renueve los tokens. El permiso mcp:research incluye las cuatro fuentes de investigación de la tabla. Las conexiones con clave API usan una cabecera X-API-Key protegida y pueden acceder a otras fuentes autorizadas.

Para probar FlashData antes de crear una cuenta, inicia una prueba con la CLI. OAuth para MCP conecta una cuenta del titular; no crea pruebas ni las vincula a una cuenta. El perfil de la CLI no se comparte automáticamente con tu cliente MCP.

- [Iniciar una prueba para agentes](https://flashdata.dev/es/docs/guides/agent-onboarding/reference.md#access)
- [Vincular la prueba y recibir las credenciales](https://flashdata.dev/es/docs/guides/agent-onboarding/reference.md#claim)
- [Reutilizar el acceso guardado](https://flashdata.dev/es/docs/guides/agent-access/reference.md#refresh)
- [Revocar el acceso](https://flashdata.dev/es/docs/guides/agent-access/reference.md#revoke)

<a id="errors"></a>

## Solución de problemas

| Problema | Qué hacer |
| --- | --- |
| Lista vacía | Si no aparecen las herramientas de FlashData, completa la autorización, vuelve a conectar y abre una nueva sesión. Comprueba la URL y el transporte Streamable HTTP. |
| invalid_client / callback error | En Codex u OpenClaw, usa la configuración exacta indicada y un navegador que pueda acceder a la URL de retorno local. Para otros clientes, usa la opción con clave API o stdio que admitan. |
| 401 | Si el acceso OAuth ha caducado o se ha revocado, vuelve a conectar. Si usas una clave API, comprueba la que has configurado en el cliente. Repite la comprobación gratuita. |
| 403 | Comprueba la fuente solicitada y los permisos de la clave. YouTube Download requiere una clave API del titular con youtube_download y almacenamiento de destino; mcp:research no incluye este permiso. |
| 402 | Consulta Billing y el precio actual. Volver a conectar una credencial válida no añade créditos. |
| 429 | Respeta Retry-After. Conserva el ID del trabajo o resultado existente antes de decidir si vuelves a intentar la tarea. |
| Espera agotada o respuesta parcial | Conserva el ID de la solicitud y consulta History. Si el resultado es grande, recupera sus siguientes partes con get_result en vez de repetir la búsqueda. |

- [Billing](https://flashdata.dev/app/billing)
- [Historial de solicitudes](https://flashdata.dev/app/jobs)

<a id="client"></a>

## Siguientes pasos

- [Crear un cliente MCP propio](https://flashdata.dev/es/docs/guides/mcp-custom-client/reference.md)
- [Configuración de Codex](https://flashdata.dev/es/docs/integrations/codex/reference.md)
- [Configuración de OpenClaw](https://flashdata.dev/es/docs/integrations/openclaw/reference.md)
- [Tareas recurrentes](https://flashdata.dev/es/docs/guides/recurring-tasks/reference.md)
