Saltar al contenido
ES
Obtener clave API
Explorar documentación

Primeros pasos

FlashData MCP

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

En esta página

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.

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
[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
codex mcp login flashdata --scopes mcp:research

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
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.

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
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.

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
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

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.

TareaHerramientaAcceso
Buscar en Googlegoogle_searchmcp:research / API key
Buscar vídeos en YouTubeyoutube_searchmcp:research / API key
Leer metadatos de vídeoyoutube_metadatamcp:research / API key
Obtener subtítulos existentesyoutube_transcriptmcp:research / API key
Descargar vídeo o audioyoutube_downloadClave API del titular + almacenamiento de destino
Consultar la cuenta y los preciosget_balance, get_pricing, get_limits, get_usageConsultas de cuenta gratuitas

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.

Solución de problemas

ProblemaQué hacer
Lista vacíaSi 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 errorEn 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.
401Si 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.
403Comprueba 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.
402Consulta Billing y el precio actual. Volver a conectar una credencial válida no añade créditos.
429Respeta Retry-After. Conserva el ID del trabajo o resultado existente antes de decidir si vuelves a intentar la tarea.
Espera agotada o respuesta parcialConserva 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.

Siguientes pasos