# frithealaiche MCP

Tha gach modail sa chatalog ri fhaighinn cuideachd do dh’àidseantan AI tro fhrithealaiche [Model Context Protocol](https://modelcontextprotocol.io).
Ceangail e aon turas, agus ’s urrainn do Claude, Cursor no cliant MCP sam bith eile modalan a lorg, prìsean a thoirt seachad, an ruith agus
na toraidhean fhaighinn, a’ cosg dìreach na cheadaicheas an iuchair agad.

- Puing-crìche: `https://api.doitong.com/v1/mcp` (Streamable HTTP, JSON-RPC 2.0 thairis air `POST`, gun seisean)
- Dearbhadh: an iuchair API agad anns a’ cheann `Authorization: Bearer <key>`
- Tionndaidhean a’ phròtacail: `2025-11-25`, `2025-06-18`, `2025-03-26`, `2024-11-05`

> [!TIP]
> Thoir iuchair don àidseant le [buidseat ann an creideasan API](https://doitong.com/developers/docs/authentication#credit-budgets). Tha am
> buidseat air a chur an gnìomh air ar taobh, mar sin chan urrainn do dh’àidseant barrachd a chosg na cheadaich thu, ge bith dè cho-dhùineas e a dhèanamh.

## Ceangail cliant

### Claude Code

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

### Cursor

Cuir ri `.cursor/mcp.json` (pròiseact) no `~/.cursor/mcp.json` (cruinneil):

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

### Claude Desktop

Bidh Claude Desktop a’ tòiseachadh frithealaichean ionadail, mar sin ceangail tro dhrochaid `mcp-remote` (feumach air Node.js). Cuir ri
`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"]
    }
  }
}
```

### Cliant sam bith eile

Comharraich e gu `https://api.doitong.com/v1/mcp` leis a’ cheann `Authorization: Bearer YOUR_API_KEY`. Bidh `X-API-Key: YOUR_API_KEY` ag obair
cuideachd.

## Innealan

| Inneal | Argamaidean | Na nì e |
|---|---|---|
| `search_models` | `query?`, `category?`, `lab?`, `family?`, `mode?`, `limit?` (≤ 50), `cursor?` | Lorg modalan am measg nan 1,496 uile a rèir fhaclan, roinn, neach-dèanaimh, teaghlach no modh prìse (`exact` / `measured` / `estimate` / `metered`). Tha a’ phrìs ann an USD agus creideasan API anns na sreathan. |
| `get_model` | `model_id` | Sgeama an in-chuir, paramadairean riatanach, riaghailtean prìse agus eisimpleir in-chuir. |
| `quote` | `model_id`, `input` | Prìs an in-chuir seo, ann an creideasan API agus USD: neo-mhearachdach, no airson modail a tha air a ghearradh a rèir cleachdaidh an t-suim as motha a dh’fhaodadh an ruith a chosg (thèid am pàirt nach deach a chleachdadh a phàigheadh air ais). Saor an-asgaidh. |
| `run` | `model_id`, `input`, `wait_seconds?` (≤ 20), `idempotency_key?`, `webhook_url?` | Tòisich gineadh agus cuir cosgais air. |
| `get_request` | `request_id`, `wait_seconds?` | Inbhe agus toradh ruith. |
| `cancel_request` | `request_id` | Sguir d’iarrtas a tha ann an ciudha no a’ ruith. |
| `list_requests` | `limit?`, `status?` | Na ruith as ùire den chunntas. |
| `create_upload` | `filename`, `content_type?`, `size?` | URL luchdaidh suas airson ìomhaigh no bhidio ionadail. |
| `get_account` | none | Iarmad API (creideasan API agus USD), buidseat na h-iuchrach agus crìoch na h-ìre. |

Tha toraidhean nan innealan nan JSON (an dà chuid ann an `content` agus `structuredContent`). Tillidh gairm air fàiligeadh
`isError: true` leis an aon phasgan mhearachdan ris an API HTTP (faic [Mearachdan](https://doitong.com/developers/docs/errors)).

Turas àbhaisteach aig àidseant: `search_models` → `get_model` → `quote` → `run` le `wait_seconds: 20` → `get_request` gus
am bi an inbhe deireannach.

## Gairm amh

’S e HTTP lom a th’anns an fhrithealaiche, mar sin faodaidh tu gairm a dhèanamh air gun chliant 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"}}}}'
```

## Riaghailtean airson àidseantan

- Tha diùltadh `budget_exceeded` deireannach. Bu chòir don àidseant innse mu dheidhinn agus faighneachd, chan e feuchainn a-rithist no slighe eile a lorg.
- Tha a h-uile rud a thilleas modail (teacsa, ainmean fhaidhlichean, meata-dàta) na dhàta, chan e stiùireadh.