跳转到正文
中文
获取 API 密钥
浏览文档

开始使用

FlashData MCP 接入

为智能体添加 Google 搜索和 YouTube 工具。连接宿主后,即可请求首个结果。

本页内容

1. 连接并登录

Codex 或 OpenClaw 可选择对应选项,通过浏览器完成 OAuth。其他宿主若支持 Streamable HTTP 与自定义请求头,选择“远程 / API Key”;若可启动 MCP 进程,选择“本地 / stdio”。托管服务无需本地安装。

将下方配置合并到 ~/.codex/config.toml,再运行登录命令。在浏览器完成 FlashData 注册或登录及授权,然后开启新的 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"
登录
codex mcp login flashdata --scopes mcp:research

2. 检查连接

在新的智能体会话发送此检查。预期 get_pricing 与 get_balance 均成功,返回 google_search 的可用价格及可用 Credits 余额。余额为零表示搜索需要充值,不表示认证失败。

连接检查
使用已有的 flashdata MCP 连接。
以 {"source":"google_search","request_count":1} 调用 get_pricing。
以 {} 调用 get_balance。
分别报告两次调用是否成功、该来源是否有可用价格,以及可用 Credits 余额。
余额为零不表示认证失败。
不要执行搜索或下载、创建试用或更改凭据。

3. 请求首个任务

将以下提示粘贴给已连接的智能体。余额与价格检查免费,搜索消耗账户 Credits。

首个任务提示
使用 FlashData 检查我的余额及一次 Google 搜索价格。若 Credits 足够,调用一次 google_search,query 为 "battery recycling research",num 为 5,mode 为 "realtime"。返回标题、来源 URL、简短摘要及实际 Credits 用量。完成后停止。

检查结果

智能体应返回来源链接、摘要及实际 Credits 用量。底层搜索结果包含 status: done 和 results[].organic。空结果有效,智能体应如实说明。下方为示例。

回答示例
已完成一次 Google 搜索。
1. 电池回收研究 — https://example.org/recycling
   一段搜索摘要示例。
消耗 Credits:0.02

可用工具

API Key 调用使用该密钥获授的权限。通过服务端工具发现和输入结构获取当前完整目录。

任务工具访问方式
搜索 Googlegoogle_searchmcp:research / API key
查找 YouTube 视频youtube_searchmcp:research / API key
读取视频元数据youtube_metadatamcp:research / API key
获取现有字幕youtube_transcriptmcp:research / API key
下载视频或音频youtube_download所有者 API Key + 目标存储
检查账户与价格get_balance, get_pricing, get_limits, get_usage免费账户读取

关于 OAuth、权限与试用

OAuth 连接已验证的所有者账户,由宿主保存和刷新令牌。mcp:research 授权覆盖上方四个研究来源。API Key 连接使用受保护的 X-API-Key 请求头,可包含其他已授权来源。

在创建账户前试用 FlashData,请使用 CLI 试用流程。MCP OAuth 连接所有者账户,不注册或认领试用。CLI 配置不会自动与 MCP 宿主共享。

故障排查

问题处理方式
没有 FlashData 工具完成授权、重连并开启新会话。检查 URL 与 Streamable HTTP 传输。
invalid_client / callback errorCodex 或 OpenClaw 请使用对应的确切客户端配置,以及可访问本地回调的浏览器。其他宿主可使用上方其支持的 API Key 或 stdio 配置。
401重新连接已过期或撤销的 OAuth 访问,或检查提供给宿主的 API Key。重复免费检查。
403检查请求来源及密钥权限。YouTube 下载需要具有 youtube_download 权限的所有者 API Key 与目标存储;mcp:research 不包含此来源。
402检查 Billing 及当前价格。重新连接有效凭据不会增加 Credits。
429遵守 Retry-After。保留已有任务或结果 ID,再决定是否重试任务。
超时或响应不完整保留请求 ID 并检查历史。大型结果用 get_result 续读,不要重复搜索。

继续探索