MCP serverio dokumentacija — sąranka ir JSON-RPC API

Prijunkite Claude, Cursor arba LM Studio prie Arttron MCP serverio: tikra JSON konfigūracija, JSON-RPC tools/call pavyzdys ir REST API žinynas.

Darbo pradžia

1. Autentifikacija

Užsiregistruokite el. paštu arba per GitHub → Gaukite API raktą → Įklijuokite jį į MCP kliento konfigūraciją

Siųskite raktą kaip Bearer žetoną: Authorization: Bearer YOUR_API_KEY.

2. Gaukite API raktą

Prisijunkite prie savo valdymo skydo → Sukurkite naują API raktą → Nukopijuokite raktą (rodomas tik vieną kartą)

claude.ai jungtis (API rakto nereikia)

Atidarykite Settings → Connectors → Add custom connector, įklijuokite jungties URL ir patvirtinkite OAuth. claude.ai užsiregistruoja pats, todėl API rakto nereikia.

MCP (JSON-RPC)

MCP endpoint kalba JSON-RPC 2.0 per Streamable HTTP. Nukreipkite klientą į https://arttron.dev/api/mcp ir autentifikuokitės Bearer raktu — dvylika įrankių atrandami automatiškai.

Jungties URL

https://arttron.dev/api/mcp

Pastaba: /api/mcp/stream yra paliktas senasis SSE maršrutas, skirtas tik REST API. Tai nėra MCP endpoint, todėl jis neveiks MCP klientuose ar jungtyse — visada naudokite https://arttron.dev/api/mcp.

Siųskite JSON-RPC 2.0 į MCP endpoint su Authorization antrašte; įrankio rezultatas grąžinamas atsakymo lauke result.content.

MCP kliento konfigūracija

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

JSON-RPC užklausa (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

Žemiau esantys paprasti REST endpoint yra atskiras, scenarijams draugiškas API — tai nėra MCP transportai. Įrankių sąrašas viešas, įrankio iškvietimui reikia Bearer rakto.

REST užklausa

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

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

Galimi įrankiai

Visus dvylika įrankių aptarnauja MCP endpoint https://arttron.dev/api/mcp. Naudokite Authorization antraštę su savo API raktu.

  • 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

Užklausų limitai

Nemokamas planas: 200 įrankių iškvietimų per mėnesį MCP raktui ir 100 API raktui — ši mėnesio kvota yra pagrindinis limitas.

Be mėnesio kvotos kiekvienas įrankis turi nedidelį limitą (pavyzdžiui, 20 DNS užklausų/s, 30 IP geolokacijų/min, 15 vaizdų tarpininkų/s); visi skaičiuojami vienam API raktui.

Reikia pagalbos?

Rašykite mums: support@arttron.dev

Atgal į MCP

Ką apima MCP dokumentacija

Dokumentacija veda nuo nulio iki pirmojo įrankio iškvietimo. Pirmas žingsnis — autentifikacija: susikurk nemokamą paskyrą ir sugeneruok API raktą arba, jei naudoji claude.ai, užregistruok jungties URL ir patvirtink OAuth raginimą, tada rakto nereikia. Antras žingsnis — kliento konfigūracija: žemiau esantis mcpServers blokas nukreipia tavo klientą į Streamable HTTP endpoint.

Likusi puslapio dalis — perdavimo formatas. MCP endpoint kalba JSON-RPC 2.0; tools/call užklausa įvardija įrankį ir perduoda jo argumentus, o rezultatas ateina content blokuose. Pavyzdys: tools/call užklausa dns_lookup su {"domain":"example.com","type":"MX"} grąžina example.com MX įrašus. Atskira, scenarijams draugiška REST sąsaja aprašyta tiems, kurie nekalba JSON-RPC.

Kaip prijungti klientą

  1. Prisijunk ir sukurk API raktą arba pridėk jungties URL claude.ai ir patvirtink OAuth.
  2. Įklijuok mcpServers bloką su endpoint https://arttron.dev/api/mcp ir savo Bearer raktu.
  3. Paleisk klientą iš naujo; visi dvylika įrankių aptinkami MCP rankos paspaudimo metu.
  4. Iškviesk įrankį, pavyzdžiui, dns_lookup, ir perskaityk rezultatą content blokuose.

Dažnai užduodami klausimai apie dokumentaciją

Kurį endpoint naudoti?

MCP klientams visada https://arttron.dev/api/mcp. Kelias /api/mcp/stream yra senasis SSE maršrutas, paliktas tik REST API, ir jis nėra MCP endpoint.

Ar claude.ai reikia API rakto?

Ne. Jungties URL pridėjimas skiltyje „Settings → Connectors → Add custom connector“ užregistruoja klientą per OAuth 2.1, todėl API rakto ten nereikia.

Ar įrankius galima iškviesti iš scenarijaus?

Taip. REST sąsaja — tools/list yra viešas, o tools/call reikalauja Bearer rakto — aprašyta tame pačiame puslapyje tiems, kurie nekalba JSON-RPC.