# FlashData MCP

Cho người đại diện của bạn Google Search và YouTube công cụ. Kết nối chủ nhà, sau đó hỏi kết quả đầu tiên.

Tài liệu tham khảo chính điển: https://flashdata.dev/vi/docs/integrations/mcp-clients
Xem lại: 2026-11-05 by FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-mcp) — Chính thức MCP máy phục vụ
- [Tham khảo MCP](https://flashdata.dev/vi/docs/mcp/reference.md) — Công cụ, tham số và câu trả lời
- [Lấy khóa API](https://flashdata.dev/app/api-keys) — Cho máy dùng xác thực đầu

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

## 1. Kết nối và ký tên vào

Chọn Codex hay OpenClaw cho trình duyệt dựa trên OAuth. Cho một máy khác, chọn từ xa / API Chìa khóa nếu nó hỗ trợ luồng được HTTP và tiêu đề tùy chỉnh, hoặc địa phương / sdio nếu nó khởi động MCP Quá trình. Máy phục vụ không cần cài đặt cục bộ.

### Codex

Kết hợp cấu hình bên dưới vào ~/.codex/config.toml, rồi chạy lệnh đăng nhập. Hoàn tất FlashData Đăng ký hoặc đăng ký và đồng ý trong trình duyệt. Bắt đầu lại từ đầu. Codex phiên chạy sau khi đăng nhập.

#### 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"
```

#### Đăng nhập

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


### OpenClaw

Chạy các lệnh này trong các OpenClaw Phân tích tác nhân của anh sử dụng. Hoàn toàn đăng ký hoặc đăng nhập và đồng ý trong trình duyệt, sau đó bắt đầu một phiên chạy mới. Bác sĩ thăm dò kiểm tra kết nối đã được lưu.

#### Cấu hình, đăng nhập và kiểm tra . Bash / PowerShell 7

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


### Điều khiển từ xa / API Khóa

Tạo một phím bằng Google Search cho phép, hoặc tái sử dụng. Thêm máy phục vụ vào máy chủ của bạn MCP thiết lập sử dụng các trường bên dưới. Đặt chìa khóa trong trường bảo vệ đầu trang và kết nối lại; không OAuth Cần phải ra lệnh.

#### MCP thiết lập

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

- [Tạo ra một API Khóa](https://flashdata.dev/app/api-keys)

### Địa phương/ Stdio

Yêu cầu Node.js 22.18+ và a API phím với Google Search Cho phép. Trộn cái này vào một máy hỗ trợ mcpServers JSON. Thay thế YOUR_API_KEY trong cấu hình được bảo vệ cục bộ, rồi khởi động lại máy. Dùng npx.cmd trên Windows nếu máy yêu cầu tên tập tin thực hiện được.

Bị kẹp npm gói điều hành cục bộ MCP máy chủ. Người đứng yên FlashData CLI là một khả năng thực hiện riêng biệt.

#### Cấu hình MCP

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

- [Tạo ra một API Khóa](https://flashdata.dev/app/api-keys)
- [Tài liệu hướng dẫn máy phục vụ cục bộ](https://github.com/flashdatadev/flashdata-mcp)


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

## 2. Kiểm tra kết nối

Gửi cái này cho tác nhân mới. Mong đợi thành công get_pricing và get_balance gọi, một cái giá sẵn có cho google_search và tiền tín dụng của anh. Một số không số dư nghĩa là bạn cần tín dụng để tìm kiếm; nó không có nghĩa là xác thực bị lỗi.

### Kiểm tra kết nối

```text
Dùng kết nối Flashdata MCP đã có.
Gọi get_pricing với {"source":"google_search","request_count":1}.
Gọi get_balance với {}.
Báo cáo xem cả hai cuộc gọi có thành công không, liệu nguồn tin có giá cả không,
và số tiền tín dụng sẵn có. Một số không số dư không không phải là một thất bại xác thực.
Đừng chạy tìm kiếm hay tải về, tạo một thử nghiệm, hoặc thay đổi giấy ủy nhiệm.
```


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

## 3. Hãy yêu cầu nhiệm vụ đầu tiên của bạn

Dán nó vào tác nhân liên lạc của anh. Kiểm tra số dư và giá cả miễn phí; tìm kiếm sử dụng tín dụng tài khoản.

### Nhắc công việc đầu tiên

```text
Dùng FlashData Để kiểm tra số dư của tôi và giá của một Google Tìm kiếm. Nếu có đủ tín dụng, hãy gọi cho tôi. google_search một lần có truy vấn "battery recycling research"num 5 và chế độ "realtime". Danh sách trở lại, nguồn URLscác đoạn trích ngắn và tín dụng thực sự được sử dụng. Dừng lại sau nhiệm vụ này.
```


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

### Kiểm tra kết quả

Người đại diện của anh nên trả lại các liên kết và trích đoạn, cộng với các tín dụng được sử dụng. Kết quả tìm kiếm tiềm ẩn status: done và results[].organic. Một kết quả rỗng là hợp lệ; tác vụ nên báo cáo nó. Ví dụ dưới đây là minh họa.

#### Ví dụ trả lời

```text
Tìm kiếm Google hoàn thành.
1. Nghiên cứu tái chế pin — https://example.org/recycling
   Một đoạn tìm kiếm.
Nguồn tư liệu được dùng: 0.02
```


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

## Công cụ sẵn sàng

API-key cuộc gọi sử dụng quyền hạn cho khóa đó. Khám phá các công cụ và giản đồ nhập của máy phục vụ cho danh mục hiện thời.

| Tác vụ | Công cụ | Truy cập |
| --- | --- | --- |
| Tìm kiếm Google | google_search | mcp:research / API key |
| Tìm đoạn phim YouTube | youtube_search | mcp:research / API key |
| Đọc siêu dữ liệu phim | youtube_metadata | mcp:research / API key |
| Lấy phụ đề đã có | youtube_transcript | mcp:research / API key |
| Tải video hay âm thanh | youtube_download | Sở hữu API Phím + kho đích |
| Kiểm tra tài khoản và giá trị | get_balance, get_pricing, get_limits, get_usage | Tài khoản miễn phí đọc |

- [Mọi công cụ và tham số](https://flashdata.dev/vi/docs/mcp/reference.md#parameters)
- [Thiết lập tải về](https://flashdata.dev/vi/docs/guides/youtube-download-guide/reference.md)

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

## Giới thiệu về OAuth, cho phép và thử nghiệm

OAuth Kết nối tài khoản chủ sở hữu đã kiểm tra của bạn và cho phép máy chủ lưu trữ và các vật kỷ niệm mới. Quỹ mcp:research bao gồm bốn nguồn nghiên cứu ở trên. API- Kết nối phím sử dụng bảo vệ X-API-Key Đầu trang và có thể bao gồm những nguồn khác có thẩm quyền.

Để thử FlashData Trước khi tạo một tài khoản, hãy sử dụng CLI Kiểm tra dòng chảy. MCP OAuth Kết nối tài khoản chủ; nó không đăng ký hoặc yêu cầu xét xử. A CLI hồ sơ không tự động được chia sẻ với bạn MCP chủ nhân.

- [Bắt đầu một thử nghiệm tác nhân](https://flashdata.dev/vi/docs/guides/agent-onboarding/reference.md#access)
- [Xác nhận và ủy nhiệm tay](https://flashdata.dev/vi/docs/guides/agent-onboarding/reference.md#claim)
- [Dùng lại quyền lưu](https://flashdata.dev/vi/docs/guides/agent-access/reference.md#refresh)
- [Thu hồi truy cập](https://flashdata.dev/vi/docs/guides/agent-access/reference.md#revoke)

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

## Khắc phục sự cố

| Vấn đề | Thử cái này đi |
| --- | --- |
| Không FlashData công cụ | Kết thúc sự đồng ý, tái kết nối và bắt đầu một phiên họp mới. Kiểm tra URL và có thể chảy HTTP Vận chuyển. |
| invalid_client / callback error | Vì Codex hay OpenClawsử dụng cấu hình ứng dụng khách chính xác của nó và một trình duyệt có thể tới được gọi lại cục bộ. Đối với một máy khác, sử dụng hỗ trợ của nó API- Khóa hay thiết lập tầng trên. |
| 401 | Kết nối đã hết hạn hoặc bị thu hồi OAuth Truy cập, hoặc kiểm tra API Phím được cung cấp cho máy. Nhắc lại, kiểm tra miễn phí. |
| 403 | Kiểm tra lại nguồn và quyền truy cập. YouTube Download yêu cầu một chủ sở hữu API phím với youtube_download và lưu trữ điểm đến; mcp:research không bao gồm cả nó. |
| 402 | Kiểm tra Billing và giá hiện tại. Kết nối lại một thẻ chứng nhận hợp lệ không thêm tín dụng. |
| 429 | Theo Retry-After. Giữ lại bất kỳ công việc hay kết quả nào đã có ID trước khi quyết định có nên thử lại hay không. |
| Đáp ứng thời hạn hoặc không đầy đủ | Giữ yêu cầu ID và kiểm tra History. Đọc các phần bổ sung lớn tiếp tục với get_result Thay vì lặp lại việc tìm kiếm. |

- [Billing](https://flashdata.dev/app/billing)
- [Yêu cầu lịch sử](https://flashdata.dev/app/jobs)

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

## Đi tiếp đi

- [Tạo một tập quán MCP ứng dụng khách](https://flashdata.dev/vi/docs/guides/mcp-custom-client/reference.md)
- [Codex cài đặt chi tiết](https://flashdata.dev/vi/docs/integrations/codex/reference.md)
- [OpenClaw cài đặt chi tiết](https://flashdata.dev/vi/docs/integrations/openclaw/reference.md)
- [Tác vụ định kỳ](https://flashdata.dev/vi/docs/guides/recurring-tasks/reference.md)
