Kaip prijungti ImonesMCP prie Claude, Cursor ir kitų DI agentų

ImonesMCP prijungimas prie DI agento — trys žingsniai: gaukite prieigą, nukreipkite klientą į adresą ir užduokite klausimą. OAuth palaikantiems klientams, tokiems kaip Claude Desktop, rakto visai nereikia; CLI ir konfigūracijos failų klientai naudoja API raktą kaip bearer token. Šis vadovas apima dažniausius klientus ir tiksliai atkartoja dokumentaciją. Nauja pati MCP tema? Pradėkite nuo kas yra MCP.

Prieš pradedant

Reikia dviejų dalykų: prieigos ir adreso.

• Prieiga. Dauguma MCP klientų prisijungimą naršyklėje atidaro automatiškai per OAuth — rakto nereikia. Automatizacijai ar CI susikurkite API raktą valdymo skyde; raktai atrodo rk_live_… ir rodomi tik vieną kartą, todėl saugokite saugioje vietoje. Raktą gaukite ir planus pamatysite kainodaros puslapyje.
• Adresas. ImonesMCP — nuotolinis MCP serveris per Streamable HTTP. Endpoint adresas rodomas dokumentacijos puslapyje ir valdymo skyde — nukopijuokite jį iš ten.

Norint pradėti, mokamo plano nereikia: nemokamas planas kas mėnesį apima įrankių iškvietimų su prieiga prie visų šešių įrankių ir be banko kortelės, todėl galite prisijungti ir paleisti tikras užklausas dar prieš nuspręsdami, ar atsinaujinti. Naudojimas matuojamas pagal kiekvieną API raktą, tad prijungę kelis agentus kiekvienam suteikite atskirą raktą — taip stebėsite juos atskirai ir galėsite vieną atšaukti nepaveikdami kitų.

Claude Desktop (OAuth)

Claude Desktop prisijungia per OAuth, todėl nereikia nei konfigūracijos failo, nei API rakto — tiesiog prisijunkite:

1. Atidarykite Claude Desktop ir eikite į Settings → Connectors.
2. Spustelėkite Add custom connector.
3. Įklijuokite endpoint kaip URL, pavadinkite ImonesMCP ir spustelėkite Add.
4. Spustelėkite Connect, prisijunkite ir patvirtinkite prieigą — įrankius Claude atras automatiškai.

Claude Code / CLI (API raktas su antrašte)

Claude Code serverį pridėkite iš terminalo viena komanda:

claude mcp add --transport http imonesmcp ENDPOINT_URL

Pakeiskite ENDPOINT_URL adresu iš dokumentacijos puslapio. Claude Code gali prisijungti per OAuth — pridėjus serverį, komanda /mcp atidarys naršyklę autentifikacijai — todėl interaktyviam naudojimui rakto nereikia. CI ar automatizacijai vietoj to perduokite API raktą kaip bearer token per antraštę ir perkraukite agentą, kad jis atrastų įrankius.

Cursor ir kiti MCP klientai

Konfigūracijos failų klientai (Cursor, VS Code, Windsurf ir kiti) nukreipiami į tą patį adresą ir siunčia jūsų API raktą kaip bearer token. Cursor redaguokite ~/.cursor/mcp.json:

{
  "mcpServers": {
    "imonesmcp": {
      "url": "ENDPOINT_URL",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Pakeiskite ENDPOINT_URL adresu, o YOUR_API_KEY — valdymo skyde susikurtu raktu, tada perkraukite klientą. VS Code naudoja .vscode/mcp.json su bloku servers ir "type": "http"; Windsurf naudoja ~/.codeium/windsurf/mcp_config.json su lauku serverUrl. Dokumentacija rodo tikslų kiekvieno kliento fragmentą su kopijavimo mygtukais.

Savi agentai su MCP SDK

Jei kuriate savo agentą, o ne naudojate paruoštą klientą, ImonesMCP elgiasi kaip bet kuris kitas nuotolinis MCP serveris. Pridėkite jį į savo agento serverių sąrašą su endpoint adresu ir antrašte Authorization: Bearer YOUR_API_KEY, o jūsų MCP kliento biblioteka atliks likusį susijungimą — atsisiųs įrankių aprašus ir atvers šešis įrankius jūsų modeliui. Kadangi transportas — Streamable HTTP, jokio lokalaus proceso ar stdio tilto nereikia; agentas prisijungia tiesiai per tinklą. Visa kita šiame vadove — adresas, bearer token, patikros užklausa — galioja nepakitę.

Patikrinkite, ar veikia

Prisijungus, agentas šešis įrankius atranda automatiškai. Patvirtinkite ryšį tikru klausimu, pavyzdžiui:

Rask veikiančias Vilniaus logistikos įmones su daugiau nei vienu
milijonu eurų pajamų ir aktyviu PVM, surikiuotas pagal pajamas.

Agentas turėtų iškviesti search_companies ir grąžinti atitinkančias įmones su jų kodais, statusais ir pajamomis. Jei taip — esate prisijungę. Vedamą pirmą paiešką rasite straipsnyje kaip rasti bet kurią Lietuvos įmonę.

Trikčių sprendimas

• Agentas nemato jokių įrankių. Perkraukite klientą pridėję serverį, kad jis iš naujo atliktų įrankių atradimą. Patikrinkite, ar endpoint adresas tiksliai sutampa su nurodytu dokumentacijos puslapyje.
• Autentifikacija nepavyksta OAuth kliente. Iš naujo paleiskite prisijungimą (Claude Code — /mcp) ir užbaikite prisijungimą naršyklėje. Paraginti patvirtinkite prašomą prieigą.
• 401 arba neautorizuota su API raktu. Patikrinkite, ar antraštė Authorization yra Bearer YOUR_API_KEY su galiojančiu, neatšauktu raktu. Raktai rodomi tik kuriant — jei pametėte, susikurkite naują valdymo skyde.
• Užklausos nustoja grąžinti rezultatus. Galbūt pasiekėte mėnesio kvotą. Naudojimas matuojamas pagal raktą; atsakyme yra aiškus raginimas atsinaujinti. Planą Pro rasite kainodaroje.

Vienas patarimas dėl saugumo: API raktą laikykite kaip slaptažodį. Nedėkite jo į viešą kodo saugyklą ar bendrinamą failą — konfigūracijos failuose, kur įmanoma, naudokite aplinkos kintamąjį. Jei įtariate, kad raktas nutekėjo, atšaukite jį valdymo skyde ir susikurkite naują; senasis iškart nustoja veikti, o kiti jūsų raktai lieka nepaliesti.

Tai visas nustatymas. Nukreipkite bet kurį MCP klientą į adresą, prisijunkite, ir jūsų agentas galės užklausti kiekvieną registruotą Lietuvos įmonę. Pilną adresą ir įrankių žinyną rasite dokumentacijoje.