MCP servera dokumentācija — iestatīšana un JSON-RPC API

Pievienojiet Claude, Cursor vai LM Studio Arttron MCP serverim: īsta JSON konfigurācija, JSON-RPC tools/call piemērs un REST API uzziņa.

Darba sākšana

1. Autentifikācija

Reģistrējieties ar e-pastu vai GitHub → Saņemiet API atslēgu → Ielīmējiet to MCP klienta konfigurācijā

Sūtiet atslēgu kā Bearer tokenu: Authorization: Bearer YOUR_API_KEY.

2. Iegūstiet API atslēgu

Pierakstieties savā vadības panelī → Izveidojiet jaunu API atslēgu → Nokopējiet atslēgu (tā tiek parādīta tikai vienu reizi)

claude.ai savienotājs (API atslēga nav nepieciešama)

Atveriet Settings → Connectors → Add custom connector, ielīmējiet savienotāja URL un apstipriniet OAuth. claude.ai reģistrējas pats, tāpēc API atslēga nav vajadzīga.

MCP (JSON-RPC)

MCP endpoint runā JSON-RPC 2.0 ar Streamable HTTP. Norādiet klientā https://arttron.dev/api/mcp un autorizējieties ar Bearer atslēgu — divpadsmit rīki tiek atklāti automātiski.

Savienotāja URL

https://arttron.dev/api/mcp

Piezīme: /api/mcp/stream ir mantotais SSE maršruts, kas saglabāts tikai REST API vajadzībām. Tas nav MCP endpoint, tāpēc tas nedarbosies MCP klientos vai savienotājos — vienmēr izmantojiet https://arttron.dev/api/mcp.

Sūtiet JSON-RPC 2.0 uz MCP endpoint ar Authorization galveni; rīka rezultāts atnāk atbildes laukā result.content.

MCP klienta konfigurācija

{
  "mcpServers": {
    "arttron": {
      "url": "https://arttron.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

JSON-RPC pieprasījums (tools/call)

POST /api/mcp
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Accept: application/json, text/event-stream

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "dns_lookup",
    "arguments": { "domain": "example.com", "type": "MX" }
  }
}

REST API

Zemāk esošie vienkāršie REST endpointi ir atsevišķs, skriptiem draudzīgs API — tie nav MCP transporti. Rīku saraksts ir publisks, rīka izsaukšanai vajag Bearer atslēgu.

REST pieprasījums

POST /api/mcp/tools/call
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "tool": "dns_lookup",
  "input": { "domain": "example.com", "type": "MX" }
}

Pieejamie rīki

Visus divpadsmit rīkus apkalpo MCP endpoint https://arttron.dev/api/mcp. Izmantojiet Authorization galveni ar savu API atslēgu.

  • dns_lookup — Resolve DNS records
  • ip_lookup — Geolocate IP addresses
  • qr_generate — Generate QR codes
  • list_versions — List available versions
  • download_dev_server — Download server binary
  • proxy_image — Proxy external images

Pieprasījumu ierobežojumi

Bezmaksas līmenis: 200 rīku izsaukumi mēnesī MCP atslēgai un 100 API atslēgai — šī mēneša kvota ir galvenais ierobežojums.

Papildus mēneša kvotai katram rīkam ir neliels ierobežojums (piemēram, 20 DNS vaicājumi/s, 30 IP ģeolokācijas/min, 15 attēlu starpnieki/s); visi tiek skaitīti uz API atslēgu.

Nepieciešama palīdzība?

Rakstiet mums: support@arttron.dev

Atpakaļ uz MCP

Ko aptver MCP dokumentācija

Dokumentācija ved no nulles līdz pirmajam rīka izsaukumam. Pirmais solis ir autentifikācija: izveido bezmaksas kontu un ģenerē API atslēgu vai claude.ai gadījumā reģistrē savienotāja URL un apstiprini OAuth uzvedni, tad atslēga nav vajadzīga. Otrais solis ir klienta konfigurācija — zemāk esošais mcpServers bloks novirza tavu klientu uz Streamable HTTP endpoint.

Pārējā lapa ir pārraides formāts. MCP endpoint runā JSON-RPC 2.0; tools/call pieprasījums nosauc rīku un nodod tā argumentus, un rezultāts pienāk content blokos. Piemērs: tools/call pieprasījums dns_lookup ar {"domain":"example.com","type":"MX"} atgriež example.com MX ierakstus. Atsevišķa, skriptiem draudzīga REST saskarne ir dokumentēta tiem, kas nerunā JSON-RPC.

Kā pievienot klientu

  1. Piesakies un izveido API atslēgu vai pievieno savienotāja URL claude.ai un apstiprini OAuth.
  2. Ielīmē mcpServers bloku ar endpoint https://arttron.dev/api/mcp un savu Bearer atslēgu.
  3. Pārstartē klientu; visi divpadsmit rīki tiek atklāti MCP rokasspiediena laikā.
  4. Izsauc rīku, piemēram, dns_lookup, un nolasi rezultātu content blokos.

Biežāk uzdotie jautājumi par dokumentāciju

Kuru endpoint izmantot?

MCP klientiem vienmēr https://arttron.dev/api/mcp. Ceļš /api/mcp/stream ir mantotais SSE maršruts, kas paturēts tikai REST API, un tas nav MCP endpoint.

Vai claude.ai ir vajadzīga API atslēga?

Nē. Savienotāja URL pievienošana sadaļā „Settings → Connectors → Add custom connector” reģistrē klientu caur OAuth 2.1, tāpēc API atslēga tur nav vajadzīga.

Vai rīkus var izsaukt no skripta?

Jā. REST saskarne — tools/list ir publisks, un tools/call prasa Bearer atslēgu — ir dokumentēta tajā pašā lapā tiem, kas nerunā JSON-RPC.