# MCP-server

Juohke modealla katalogas lea maid AI-ageanttaide olamuttus [Model Context Protocol](https://modelcontextprotocol.io)
servera bokte. Čatnase dan oktii, ja Claude, Cursor dahje eará MCP-klieanta sáhttá gávdnat modeallaid, gáibidit hattiid, vuodjut daid ja viežžat
bohtosiid, geavahit du API-čoavdda dušše dan rádjai go man ollu lea lohpiduvvon.

- Loahppačuokkis: `https://api.doitong.com/v1/mcp` (Streamable HTTP, JSON-RPC 2.0 `POST` bokte, sessiija haga)
- Autentiseren: du API-čoavdda `Authorization: Bearer <key>`-headeris
- Protokollaveršuvnnat: `2025-11-25`, `2025-06-18`, `2025-03-26`, `2024-11-05`

> [!TIP]
> Atte ageantii čoavdda mas lea [bušeahtta API-kredihttain](https://doitong.com/developers/docs/authentication#credit-budgets). Dan
> bušeahtta čáhčá min bealde, nu ahte ageanta ii sáhte goassege geavahit eanet go don leat lobiidan, beroškeahttá das maid son mearrida dahkat.

## Čatnat klieanta

### Claude Code

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

### Cursor

Lasihe `.cursor/mcp.json`-fiilii (prošeakta) dahje `~/.cursor/mcp.json`-fiilii (globála):

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

### Claude Desktop

Claude Desktop álggaha báikkálaš serveriid, nu ahte čatnat dan `mcp-remote`-laktimii (dárbbaša Node.js). Lasihe
`claude_desktop_config.json`-fiilii:

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

### Eará klieanta

Čáje dan `https://api.doitong.com/v1/mcp`-loahppačuokkisii headerain `Authorization: Bearer YOUR_API_KEY`. `X-API-Key: YOUR_API_KEY` doaibmá
maiddái.

## Veahkkeneavvut

| Veahkkeneava | Argumeanttat | Maid dat dahká |
|---|---|---|
| `search_models` | `query?`, `category?`, `lab?`, `family?`, `mode?`, `limit?` (≤ 50), `cursor?` | Oza modeallaid buot 1 496 modeallain sániid, kategoriija, ráhkadeaddji, bearaša dahje hattimáhtu (`exact` / `measured` / `estimate` / `metered`) vuođul. Ráidut čájehit hatti USD:n ja API-kredihttain. |
| `get_model` | `model_id` | Sisa-addi-skiema, dárbbašlaš paramehterat, hattinjuolggadusat ja ovdamearka-sisa-addi. |
| `quote` | `model_id`, `input` | Dán sisa-addi haddi API-kredihttain ja USD:n: dárkilis haddi, dahje modeallii mii máksá geavaheami vuođul dat eanemus maid vuojus sáhttá máksit (geavakeahtes oassi máhcaheapmi). Nuollut. |
| `run` | `model_id`, `input`, `wait_seconds?` (≤ 20), `idempotency_key?`, `webhook_url?` | Álggat ráhkadeami ja máksit dan. |
| `get_request` | `request_id`, `wait_seconds?` | Vuojusa stáhtus ja boađus. |
| `cancel_request` | `request_id` | Gaskkalduhte jearaldaga mii vuordá dahje manná. |
| `list_requests` | `limit?`, `status?` | Konto ođđaseamos vuojusat. |
| `create_upload` | `filename`, `content_type?`, `size?` | Lokála govva- dahje video-fiila loktenURL. |
| `get_account` | none | API-saldo (API-kredihtat ja USD), čoavdda bušeahtta ja rájádus. |

Veahkkeneavva-bohtosat leat JSON (sihke `content` ja `structuredContent` siste). Ii-lihkostuvvan gohččun máhcaha `isError: true` oktan
seamma HTTP API:a meattáhuseahpega (geahčade [Meattáhusat](https://doitong.com/developers/docs/errors)).

Dábálaš ageanta-gearddu: `search_models` → `get_model` → `quote` → `run` `wait_seconds: 20`-ain → `get_request` dassážii go
stáhtus lea loahpalaš.

## Raw call

Server lea čielga HTTP, nu ahte sáhtát gohččut dan ilman MCP-klieantta:

```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"}}}}'
```

## Njuolggadusat ageanttaide

- `budget_exceeded`-biehttaleapmi lea loahpalaš. Ageanta galgá dieđihit dan ja jearrat, ii ge fas geahččalit dahje ohcat eará geainnu.
- Buot maid modealla máhcaha (teaksta, fiilanamat, metadata) lea diehtu, ii ge bagadus.