MCP serveri dokumentatsioon — seadistus ja JSON-RPC API

Ühenda Claude, Cursor või LM Studio Arttron MCP serveriga: päris JSON-konfiguratsioon, JSON-RPC tools/call näide ja REST API viide.

Alustamine

1. Autentimine

Registreeru e-posti või GitHubiga → Saa API-võti → Kleepige see MCP-kliendi seadistusse

Saada võti Bearer-tokenina: Authorization: Bearer YOUR_API_KEY.

2. Hankige API-võti

Logi sisse oma juhtpaneelile → Loo uus API-võti → Kopeeri võti (näidatakse ainult üks kord)

claude.ai konnektor (API-võtit pole vaja)

Ava Settings → Connectors → Add custom connector, kleebi konnektori URL ja kinnita OAuth. claude.ai registreerib end ise, seega API-võtit pole vaja.

MCP (JSON-RPC)

MCP endpoint räägib JSON-RPC 2.0-d Streamable HTTP peal. Suuna klient aadressile https://arttron.dev/api/mcp ja autendi Bearer-võtmega — kaksteist tööriista avastatakse automaatselt.

Konnektori URL

https://arttron.dev/api/mcp

Märkus: /api/mcp/stream on vana SSE-marsruut, mis on jäetud ainult REST API jaoks. See ei ole MCP endpoint, seega ei tööta see MCP-klientides ega konnektorites — kasutage alati https://arttron.dev/api/mcp.

Saada JSON-RPC 2.0 MCP endpointile koos Authorization päisega; tööriista tulemus tuleb vastuses väljas result.content.

MCP-kliendi konfiguratsioon

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

JSON-RPC päring (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

Allolevad lihtsad REST endpointid on eraldi, skriptisõbralik API — need ei ole MCP-transpordid. Tööriistade loend on avalik, tööriista kutsumiseks on vaja Bearer-võtit.

REST päring

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

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

Saadaolevad tööriistad

Kõiki kaksteist tööriista pakub MCP endpoint https://arttron.dev/api/mcp. Kasutage Authorization päist oma API-võtmega.

  • 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

Päringupiirangud

Tasuta tase: 200 tööriistakõnet kuus MCP-võtme kohta ja 100 API-võtme kohta — see kuukvoot on peamine limiit.

Lisaks kuukvoodile kehtib igal tööriistal väike limiit (näiteks 20 DNS-päringut/s, 30 IP-geolokatsiooni/min, 15 pildiproxy't/s); kõik loetakse API-võtme kohta.

Vajad abi?

Kirjutage meile: support@arttron.dev

Tagasi MCP juurde

Mida MCP dokumentatsioon hõlmab

Dokumentatsioon viib nullist esimese tööriistakutsuni. Esimene samm on autentimine: loo tasuta konto ja genereeri API-võti või claude.ai jaoks registreeri konnektori URL ja kinnita OAuth-i viip, siis pole võtit vaja. Teine samm on kliendi konfiguratsioon — allolev mcpServers-plokk suunab sinu kliendi Streamable HTTP endpointile.

Ülejäänud leht on edastusvorming. MCP-endpoint räägib JSON-RPC 2.0 keeles; tools/call päring nimetab tööriista ja edastab selle argumendid ning tulemus saabub content-plokkides. Näide: tools/call päring dns_lookupile koos {"domain":"example.com","type":"MX"} tagastab example.com MX-kirjed. Eraldi, skriptisõbralik REST-liides on dokumenteeritud neile, kes JSON-RPC-d ei räägi.

Kuidas klienti ühendada

  1. Logi sisse ja loo API-võti või lisa claude.ai-s konnektori URL ja kinnita OAuth.
  2. Kleebi mcpServers-plokk endpointiga https://arttron.dev/api/mcp ja oma Bearer-võtmega.
  3. Taaskäivita klient; kõik kaksteist tööriista avastatakse MCP käesurumise ajal.
  4. Kutsu tööriista, näiteks dns_lookup, ja loe tulemus content-plokkidest.

Korduma kippuvad küsimused dokumentatsiooni kohta

Millist endpointi kasutada?

MCP-klientide jaoks alati https://arttron.dev/api/mcp. Aadress /api/mcp/stream on vana SSE-marsruut, mis on jäetud ainult REST API jaoks, ega ole MCP-endpoint.

Kas claude.ai puhul on API-võti vajalik?

Ei. Konnektori URL-i lisamine jaotises „Settings → Connectors → Add custom connector” registreerib kliendi OAuth 2.1 kaudu, seega API-võtit seal vaja ei lähe.

Kas tööriistu saab kutsuda skriptist?

Jah. REST-liides — tools/list on avalik ja tools/call nõuab Bearer-võtit — on dokumenteeritud samal lehel neile, kes JSON-RPC-d ei räägi.