# MCP ᠰᡝᡵᡥᡝᠨ

ᠵᠠᠯᠪᠠᠷᡳ ᡳᠴᡳ ᡳᠯᡥᠠᠨᡳ ᡝᠮᡠ ᡴᠠᡳ ᠮᠣᡩᡝᠯ ᠮᠠᠨᡳ ᠮᠣᡩᡝᠯᡳ ᡤᠠᠯᡤᠠᠨ ᡩᡝ [Model Context Protocol](https://modelcontextprotocol.io)
ᠰᡝᡵᡥᡝᠨ ᡳ ᠠᡤᡝᠨᡨ ᡩᡝ ᠠᠮᠪᠠᠨᠠᠮᠪᡳ. ᡝᠮᡠ ᠮᠠᠩᡤᡳ ᠵᠠᠯᠪᠠᠮᠪᡳ᠂ ᠮᠠᠨᡳ ᠵᡳᡵᡤᠠ ᠵᠠᠯᡳᠨ ᡳᠯᡤᠠᠨ ᡩᡝ ᡳᠨᡠ ᠮᠣᡩᡝᠯ ᡳᠯᡥᠠᠮᠪᡳ᠂ ᡝᠮᡠᠨ ᡩᡝ ᠮᠣᠯᠠᠮᠪᡳ᠂ ᠵᠠᡶᠠᠮᠪᡳ ᡝᠮᡠᠨ ᡩᡝ ᠵᡠᠸᡝᠮᠪᡳ᠂ ᠮᠠᠨᡳ ᠵᡳᡵᡤᠠ ᡳ ᠵᠠᠯᡤᠠᠨ ᠵᠠᡴᡡᡶᡳ᠂ ᡝᠮᡠᠨ ᡩᡝ ᠵᠠᡴᡡ ᠪᠠᠨᠠᡥᠠ ᠰᡝᠮᠪᡳ.

- ᠵᠠᠯᡳᠨ ᡳᠯᡤᠠᠨ: `https://api.doitong.com/v1/mcp` (Streamable HTTP, JSON-RPC 2.0 ᠵᡝᠨ `POST` ᡳ ᡤᠠᠰᡥᠠᠨ᠂ ᠰᡝᠰᡝ ᡠᠯᠠᡥᠠ)
- ᠵᠠᡵᡤᠠᠨ: `Authorization: Bearer <key>` ᠮᡝᡳ ᠵᡳᡵᡤᠠ ᡩᡝ ᠪᡳ
- ᠵᠠᡴᡠᠨ ᠵᠠᠯᠪᠠᠨ ᠠᠩᡤᠠᠯᠠᠪᡠᡵᡳ: `2025-11-25`, `2025-06-18`, `2025-03-26`, `2024-11-05`

> [!TIP]
> ᠠᡤᡝᠨᡨ ᡩᡝ [API ᠵᠠᠯᡤᠠᠨ ᡳ ᡶᡳᠶᠠᠨ](https://doitong.com/developers/docs/authentication#credit-budgets) ᠪᡳ ᠵᡳᡵᡤᠠ ᠪᡠᠮᡝ. ᠮᡳᠨᡳ
> ᡶᡳᠶᠠᠨ ᠪᡝ ᠮᡳᠨᡳ ᠵᠠᠯᠠᠨ ᡩᡝ ᠠᠰᡥᠠᠨ ᠵᠠᠯᠪᠠᠮᠪᡳ᠂ ᠠᡤᡝᠨᡨ ᠠᠨᡳᠶᠠ ᠵᡠᠸᡝ ᠵᠠᠯᠠᠨ ᠪᡠᠮᠪᡳ ᠰᡝᠮᡝ ᡶᡳᠶᠠᠨ ᡳ ᠵᡠᠸᡝ ᡠᠰᡳᡥᠠ ᠠᠮᡝᠪᡠᠮᠪᡳ.

## ᠵᠠᠯᠪᠠᠮᠪᡳ ᠵᡠᠸᡝ ᠮᡝᠳᡝᠨ

### Claude Code

```bash
claude mcp add --transport http doitong-models https://api.doitong.com/v1/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
```

### Cursor

`.cursor/mcp.json` (ᡝᡵᡝᠮᡝ) ᠠᡳ `~/.cursor/mcp.json` (ᡝᠯᡥᡝ) ᡩᡝ ᠵᠠᠯᠪᠠᠮᠪᡳ:

```json
{
  "mcpServers": {
    "doitong-models": {
      "url": "https://api.doitong.com/v1/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
```

### Claude Desktop

Claude Desktop ᠣᠨᠴᠣᡥᠣᠨ ᠰᡝᡵᡥᡝᠨ ᠵᠠᠯᠪᠠᠮᠪᡳ᠂ ᡝᡵᡝ ᡩᡝ `mcp-remote` ᠪᠠᠶᠠᠨ ᡳ (Node.js ᠵᠠᡴᡡ) ᠵᡝᠨ ᠵᠠᠯᠪᠠᠮᠪᡳ. ᡝᡵᡝ ᡩᡝ
`claude_desktop_config.json` ᠵᠠᠯᠪᠠᠮᠪᡳ:

```json
{
  "mcpServers": {
    "doitong-models": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.doitong.com/v1/mcp", "--header", "Authorization: Bearer YOUR_API_KEY"]
    }
  }
}
```

### ᡝᠯᡤᡳ ᠠᡳ ᡤᡝᠯᡳ ᠵᡠᠸᡝ ᠮᡝᠳᡝᠨ

`https://api.doitong.com/v1/mcp` ᡩᡝ ᠵᠠᠯᠪᠠᠮᠪᡳ᠂ `Authorization: Bearer YOUR_API_KEY` ᠵᠠᠯᠪᠠᠨ ᠵᡝᠨ. `X-API-Key: YOUR_API_KEY` ᠣᠴᡳ
ᠮᡠ ᡳᠯᠠᠴᡳ.

## ᠵᠠᠯᠪᠠᠨ ᡠᠰᡳᡥᠠ

| ᠵᠠᠯᠪᠠᠨ | ᠵᠠᡴᡠᠨ | ᡝᠨᡝᠨ ᠠᡵᠠᠮᠪᡳ |
|---|---|---|
| `search_models` | `query?`, `category?`, `lab?`, `family?`, `mode?`, `limit?` (≤ 50), `cursor?` | ᡝᠮᡠᠨ 1,496 ᡩᡝᡵᡳ ᡳᠨᡠ ᡤᠠᠯᠠ ᡩᡝᠪᡝᠰᡝᠨ᠂ ᡴᠠᠲᡝᡤᠣᡵᡳ᠂ ᠪᡠᠶᡝᠮᡝᠮᡝᠨ᠂ ᡠᠰᡳᡥᠠᠨ ᠠᠶᠠᠨ ᠠᠮᡠᠯᠠᠮᠪᡳ (`exact` / `measured` / `estimate` / `metered`). ᠵᡠᠰᡝᠨ ᡩᡝ USD ᠪᠠ API ᠵᠠᠯᡤᠠᠨ ᡳ ᠵᠠᠯᡤᠠᠨ ᠪᡳ. |
| `get_model` | `model_id` | ᡝᡵᡝᠮᡝ ᠪᡠᠮᡝ ᡳ ᠵᠠᡴᡠᠨ ᠵᠠᡴᡡᡶᡳ ᠪᡠᠮᠪᡳ᠂ ᠵᠠᠯᡤᠠᠨ ᡳ ᠵᠠᠯᠪᠠᠨ ᠪᠠ ᠵᠠᠯᠪᠠᠨ ᡳ ᠵᠠᠩᡤᡳ. |
| `quote` | `model_id`, `input` | ᡝᡵᡝᠮᡝ ᠪᡠᠮᡝ ᡳ ᠵᠠᠯᡤᠠᠨ᠂ API ᠵᠠᠯᡤᠠᠨ ᠪᠠ USD ᡳ: ᡝᠰᡝ ᠵᠠᠯᡤᠠᠨ᠂ ᠠᠶᠠᠨ ᡩᡝ ᠵᠠᠯᡤᠠᠨ ᠣᠯᡥᠣ ᠮᠣᡩᡝᠯ ᡳ ᠵᠠᠯᡤᠠᠨ ᡳ ᠵᡠᠸᡝ ᠠᠶᠠᠨ (ᠵᠠᠯᡤᠠᠨ ᠠᠮᡝᠪᡠᠮᠪᡳ). ᠠᠮᡠᠯᠠᠩᡤᠠ. |
| `run` | `model_id`, `input`, `wait_seconds?` (≤ 20), `idempotency_key?`, `webhook_url?` | ᠪᡠᠶᡝᠮᡝ ᠵᠠᠯᠪᠠᠮᠪᡳ ᠪᠠ ᠵᠠᠯᡤᠠᠨ ᠪᡠᠮᠪᡳ. |
| `get_request` | `request_id`, `wait_seconds?` | ᠵᠠᠯᠪᠠᠨ ᡳ ᠰᡝᡵᡥᡝᠨ ᠪᠠ ᠵᠠᡴᡠᠨ. |
| `cancel_request` | `request_id` | ᠵᠠᠯᠪᠠᠨ ᡳ ᡝᠨᡝᠨ ᠪᠠ ᠵᠠᠯᠪᠠᠨ ᡳ ᠠᠮᠠᠯᠠᠨ ᠪᡝ ᠵᠠᡶᠠᠮᠪᡳ. |
| `list_requests` | `limit?`, `status?` | ᠪᠠᠯᠠᠨᠰᡳ ᡳ ᠰᡠᠯᡥᡝ ᠵᠠᠯᠪᠠᠨ. |
| `create_upload` | `filename`, `content_type?`, `size?` | ᡝᠯᡥᡝᠮᡝ ᠪᡳ ᡤᠠᠳᠠᠨ ᠠᠶᠠᠨ ᠠᡳ ᠰᡠᠨᡤᠠ ᡳ ᡶᡳᠯᡝ ᡳ ᠠᠴᠠᠨ ᠵᠠᠯᡳᠨ. |
| `get_account` | none | API ᠪᠠᠯᠠᠨᠰᡳ (API ᠵᠠᠯᡤᠠᠨ ᠪᠠ USD)᠂ ᠵᡳᡵᡤᠠ ᡳ ᡶᡳᠶᠠᠨ ᠪᠠ ᠵᠠᠯᠪᠠᠨ ᡳ ᠵᡠᠸᡝ. |

ᠵᠠᠯᠪᠠᠨ ᡳ ᠵᡠᠰᡝᠨ JSON (ᡝᠮᡠ ᠵᡝᠨ `content` ᠪᠠ `structuredContent` ᡩᡝ) ᠪᡳ. ᡝᠰᡝ ᠵᠠᠯᠪᠠᠨ ᠪᡝ ᠠᡵᠠᠮᡝ ᡳᠯᡝᠨᠠᠮᠪᡳ `isError: true` ᠪᠠ ᠮᡝᡳ HTTP API ᡳ ᠠᠴᠠᠨ ᠵᡠᠰᡝᠨ ([ᠠᠯᡤᠠᠨ](https://doitong.com/developers/docs/errors)) ᠪᡠᠮᠪᡳ.

ᡝᠮᡠ ᠠᡤᡝᠨᡨ ᡳ ᠵᠠᠯᠪᠠᠨ: `search_models` → `get_model` → `quote` → `run` ᡳ `wait_seconds: 20` → ᠰᡝᡵᡥᡝᠨ ᡳ ᡝᠨᡝᠨ ᠪᡠᠮᡝ ᡩᡝᡵᡳ `get_request`.

## ᠵᠠᠯᠪᠠᠨ ᡳ ᠪᠣᠯᠣ

ᠰᡝᡵᡥᡝᠨ ᠵᠠᠯᡳᠨ HTTP ᠪᡳ᠂ ᡝᠮᡠᠨ MCP ᠮᡝᠳᡝᠨ ᡠᡴᠰᡳ ᠵᠠᠯᠪᠠᠮᠪᡳ:

```bash
curl -X POST "https://api.doitong.com/v1/mcp" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
       "params": {"name": "quote", "arguments": {"model_id": "flux/schnell", "input": {"prompt": "A lighthouse at dusk"}}}}'
```

## ᠠᡤᡝᠨᡨ ᡳ ᡥᠠᠴᡳᠨ

- `budget_exceeded` ᡳ ᠠᡴᡡ ᠠᠰᡥᠠᠨ ᠵᡠᠸᡝ ᠪᡳ. ᠠᡤᡝᠨᡨ ᡝᠨᡝᠨ ᠪᡝ ᡨᠣᠯᠣᠮᠪᡳ ᠪᠠ ᡶᡠᠨᡩᡝ ᠵᠠᠯᠪᠠᠮᠪᡳ᠂ ᡝᡵᡝ ᠵᠠᠯᠪᠠᠨ ᠠᠮᡠᠯᠠᠮᠪᡳ ᠪᠠ ᡠᠯᡥᠠ ᠵᠠᠯᡳᠨ ᡳᠯᡥᠠᠮᠪᡳ ᡠᠯᡥᡝᠨ ᠪᡝ ᡠᠯᡥᡝ ᠵᠠᠯᠪᠠᠨ ᠠᠮᡠᠯᠠᠮᠪᡳ.
- ᠮᠣᡩᡝᠯ ᡳ ᠠᠴᠠᠨ (ᡥᡡᠯᠠᠨ᠂ ᡶᡳᠯᡝ ᡳ ᡩᡝᡵᡤᡳ᠂ ᠮᠠᠲᠠᡩᠠ) ᡠᠯᡥᡝᠨ ᡩᠠᡵᠠᠨ ᠪᡳ᠂ ᠠᠴᠠᠨ ᡝᠮᡝ ᠪᡳ ᡠᠯᡥᡝᠨ ᡳ ᠵᠠᡴᡠᠨ ᠪᡠᠮᠪᡳ.
