Nodaryn MCP-palvelin

Nodarylla on etäkäytettävä MCP-palvelin, joten tekoälyagentti lukee ja kirjoittaa työtilaasi kuin tiimikaveri: samat asiakirjat, samat oikeudet, sinun nimissäsi kirjautuneena.

Lyhyesti

Osoite: https://nodary.ai/api/mcp
Siirtotapa: Streamable HTTP (JSON-RPC POST-pyyntöinä)
Kirjautuminen: OAuth 2.1 dynaamisella asiakasrekisteröinnillä ja PKCE:llä tai API-avain
Käyttöoikeus: Sisältyy kaikkiin tilauksiin; Free-tilauksessa sen rajoissa
Löydettävyys: https://nodary.ai/.well-known/oauth-protected-resource/api/mcp · https://nodary.ai/.well-known/mcp.json

Claude Code: Suorita tämä komento päätteessä (lisää --scope user, jos haluat käyttää Nodarya kaikissa projekteissa):

claude mcp add --transport http nodary https://nodary.ai/api/mcp

Mikä se on

Model Context Protocol (MCP) on avoin standardi, jonka avulla tekoälyasiakasohjelmat käyttävät ulkoisia työkaluja. Nodaryn palvelin antaa agentille saman työtilan, jota tiimisi käyttää: projektit, asiakirjat ja niiden linkit, laskentataulukot, kuvat, käännöstaulukot, dialogit ja taulut.

Agentti ei saa kopiota. Se lukee sen, mitä työtilassa on juuri nyt, kirjoittaa sinne, minne pyydät, ja jokaisessa tuloksessa on linkki, jonka ihminen voi avata tarkistaakseen agentin työn.

Kirjautuminen

Useimmat asiakasohjelmat kirjautuvat OAuthilla: anna niille palvelimen osoite, niin ne avaavat selaimeesi Nodaryn kirjautumis- ja suostumussivun. Nodary tukee OAuth 2.1:tä dynaamisella asiakasrekisteröinnillä ja PKCE:llä, joten asiakastunnusta ei tarvitse luoda eikä mitään tarvitse kopioida. Käyttöoikeustunnukset ovat voimassa tunnin, ja asiakasohjelma uusii ne.

Yksi yhteys voi ulottua useaan työtilaan. Jos olet usean työtilan jäsen, suostumussivu luettelee ne kaikki valittuina: sovellus ulottuu silloin niihin työtiloihin, jotka jätät valituiksi, eikä muihin. ”Myös työtilat, joihin liityn myöhemmin” on pois päältä, ellet valitse sitä. Tällaisessa yhteydessä jokainen työkalu ottaa workspace-arvon (tunniste, slug tai nimi): jotain muuttavan kutsun on nimettävä se, ilman sitä tehty luku toimii vain siellä, missä sen tunnisteet ovat, ja jokainen tulos alkaa työtilalla, jossa se suoritettiin. API-avain pysyy sidottuna yhteen työtilaan.

Asiakasohjelma, joka ei pysty kirjautumaan, voi käyttää sen sijaan API-avainta: luo avain profiilissasi kohdassa API keys & MCP (se alkaa merkeillä gdc_) ja lähetä se otsakkeessa Authorization: Bearer gdc_… Avaimen voi rajata yhteen projektiin.

Kuka voi käyttää sitä

MCP-palvelin sisältyy kaikkiin tilauksiin, Free, Pro, Studio ja Enterprise, jokaiselle jäsenelle ilman lisähintaa.

Free-tilauksessa agentti lukee ja kirjoittaa kuten maksullisessa tilauksessa niin kauan kuin työtila pysyy tilauksen rajoissa: projekteja 1, asiakirjoja ja kansioita 10 ja jäseniä 2. Kirjoitus, joka ylittäisi rajan, hylätään, ja vastaus kertoo rajan sekä sen, miten se poistetaan: niin kauan kuin työtila voi vielä saada kokeilunsa, linkin hallintapaneeliin, jossa omistaja tai ylläpitäjä aloittaa Studion 14 päivän kokeilun (MCP mukana, ilman korttia); muuten linkin hinnastoon.

Työtila, joka ylittää Free-tilauksen kokeilunsa jälkeen ilman tilausta, on lukittu, kunnes sille otetaan tilaus: agentit on katkaistu siellä, myös lukemisesta. Yhteys pelkästään tähän työtilaan saa jokaiseen pyyntöön vastauksen quota_locked, jossa kerrotaan, mikä ylittää rajan ja missä omistaja voi tilata; usean työtilan yhteys saa quota_locked-vastauksen (tai epäonnistuneen maksun jälkeen billing_locked) vain lukittuun työtilaan kohdistuviin kutsuihin työkaluvirheenä ja toimii muissa edelleen.

Hinnat

Mitä agentti voi tehdä

Työkaluja on 92, ja ne on ryhmitelty tähän tehtävänsä mukaan. Jokainen kertoo asiakasohjelmalle, lukeeko se pelkästään ja voiko sen kirjoitus korvata jotain, jotta asiakasohjelma voi kysyä sinulta ennen kuin se toimii.

Etsi ja lue

Projektit, asiakirjat linkkeineen ja historioineen, kommentit, tietomuistiinpanot, tallennetut näkymät ja kontekstikoosteet. Tuloksissa on linkkejä, joita ihmiset voivat avata.

list_games
list_stars
search_documents
get_document
get_star
get_tree
list_templates
list_members
list_project_knowledge
get_project_knowledge
list_comments
get_canon
list_versions
get_version
diff_versions
list_deleted_stars
list_context_briefs
get_context_brief
list_saved_views
get_saved_view
list_favorites
get_workspace_usage
list_properties
get_file_url
describe_blocks
run_view
list_workspaces

Kirjoita ja järjestä

Luo ja muokkaa asiakirjoja lohko kerrallaan, sijoita ne kansioihin, linkitä ne, lisää tunnisteita, kommentoi, aseta ominaisuuksia ja ratkaise ristiriitoja. Poistetun asiakirjan voi palauttaa.

create_game
update_game
rename_workspace
create_starter_constellation
create_from_template
create_star
create_stars
write_document
append_document
edit_document
update_star
update_stars
delete_star
restore_star
create_cluster
move_to_cluster
link_stars
unlink_stars
set_tags
save_project_knowledge
add_comment
add_comments
resolve_comment
list_contradictions
report_contradiction
resolve_contradiction
save_context_brief
save_saved_view
set_favorite
define_properties
set_properties
restore_version
edit_comment
delete_comment
delete_project_knowledge
remove_context_brief
remove_saved_view
open_daily_note

Grafiikan katselmointi ja kuvat

Tuo kuvia, katso niitä yhdessä ihmisten niihin piirtämien muistiinpanojen kanssa, tee päätöksiä, kirjaa huomioita ja merkitse toimituksia tunnisteilla (jokainen päätös allekirjoitetaan tekijän nimellä ja ajankohdalla), muunna moodboard paletiksi ja vertaa kuvaa siihen sekä valmistele alihankkijalle palautelomake.

add_image
start_upload
add_media
get_image
get_moodboard
render_board
edit_board
find_pictures
update_pictures
get_art_review
extract_palette
check_palette
feedback_sheet
restore_image_version
set_image_origin

Laskentataulukot ja tasapainotus

Lue taulukko laskettuina arvoina ja näe kunkin solun taustalla oleva kaava, kirjoita soluja osoitteen tai rivin mukaan ja lue saalistaulukosta, mitä se merkitsee pelaajille.

get_sheet
set_cells
analyze_drops

Lokalisointi ja dialogi

Näe kunkin kielen edistyminen käännöstaulukossa, kirjoita käännöksiä avaimen mukaan ja tarkista haarautuva dialogi, joka viedään Yarn Spinner -skriptinä.

get_localization
set_translations
check_dialogue

Tuotanto

Aseta määräpäiviä, pyydä ja lähetä katselmointeja, katso mitä on muuttunut viime aikoina ja saavutetaanko virstanpylväs ajallaan.

get_progress
recent_changes
set_due_date
set_due_dates
request_review
submit_review

Kehotteet ja resurssit

Valmiita pyyntöjä, joita asiakasohjelma voi tarjota komentoina:

weekly-summary: Mitä työtilassa tai yhdessä projektissa muuttui tällä viikolla: mitä kirjoitettiin, päätettiin ja katselmoitiin ja mikä on yhä avoinna.
art-review: Missä grafiikan katselmointi on menossa: päätöstä odottavat kuvat, paletista poikkeavat kuvat ja mitä seuraavaksi pitää päättää.
playtest-to-tasks: Muuttaa pelitestauksen muistiinpanot tehtäviksi ja linkittää jokaisen siihen suunnitteluasiakirjaan, jota se koskee.
balance-review: Lukee saalistaulukon tai etenemiskäyrän ja kertoo, mitä se merkitsee pelaajille ja mikä näyttää olevan pielessä.

Resursseja, jotka asiakasohjelma voi liittää ilman työkalukutsua:

nodary://star/{id}: asiakirja Markdown-muodossa
nodary://project/{id}: projektin rakenne

Turvallisuus

Agentti toimii sen henkilön nimissä, joka sen yhdisti: se näkee ja muuttaa vain sitä, mihin tällä henkilöllä on oikeus, ja projektiin rajattu avain pysyy siinä projektissa.
Usean työtilan yhteydessä mitään ei ratkaista työtilasta toiseen: tunnisteet ja otsikot haetaan vain kutsun nimeämästä työtilasta, toisen työtilan tunniste hylätään ennen kuin mitään suoritetaan, ja jokainen tulos nimeää työtilansa.
Asiakirjat säilyttävät versiohistoriansa, ja poistetun asiakirjan voi palauttaa.
Kirjoittavat työkalut ottavat vastaan idempotenssiavaimen: katkenneen yhteyden jälkeen uudelleen lähetetty kutsu palauttaa ensimmäisen tuloksen eikä kirjoita kahdesti.
Yhteys tekee enintään 120 pyyntöä minuutissa; kirjoittamisella ei ole päivärajaa.
Grafiikan katselmoinnin päätökset allekirjoitetaan päätöksen tehneen henkilön nimellä ja ajankohdalla.
Nodary kertoo jokaiselle agentille, että asiakirjojen ja kommenttien teksti on sisältöä, jonka parissa työskennellään, eikä noudatettavia ohjeita. Se, miten agentti toimii tämän pohjalta, riippuu agentista itsestään.

Yhdistä asiakasohjelmasi

Käytä osoitetta https://nodary.ai/api/mcp. Jokainen alla oleva asiakasohjelma on tarkistettu sen omaa dokumentaatiota vasten 1.10.2026.

Claude (claude.ai ja Claude Desktop)

Avaa Customize ja sitten Connectors, ja valitse Add custom connector.
Syötä https://nodary.ai/api/mcp. Kun Claude kysyy rekisteröintitapaa, valitse Register automatically.
Yhdistä, kirjaudu Nodaryyn ja hyväksy käyttöoikeus.

Mukautetut liittimet ovat käytettävissä Free-, Pro-, Max-, Team- ja Enterprise-tilauksissa; Free-tilille voi lisätä yhden. Team- ja Enterprise-tilauksissa omistaja lisää liittimen ensin organisaatiolle.

ChatGPT

Ota Developer mode käyttöön kohdassa Settings, osiossa Security and login.
Luo etä-MCP-palvelimelle sovellus osoitteella https://nodary.ai/api/mcp ja OAuth-kirjautumisella.
Kirjaudu Nodaryyn ja hyväksy käyttöoikeus. Työkalut näkyvät sen jälkeen viestikentän Developer mode -tilassa.

Developer mode on käytettävissä verkossa Plus-, Pro-, Business-, Enterprise- ja Education-tileillä; Business- ja Enterprise-tileillä ylläpitäjän on ehkä sallittava se. ChatGPT yhdistää vain OAuthilla, ei API-avaimella.

Claude Code

Suorita tämä komento päätteessä (lisää --scope user, jos haluat käyttää Nodarya kaikissa projekteissa):
```
claude mcp add --transport http nodary https://nodary.ai/api/mcp
```
Kirjoita Claude Codessa /mcp, valitse nodary ja kirjaudu selaimessa.

Vaihtoehtoisesti API-avaimella

claude mcp add --transport http nodary https://nodary.ai/api/mcp \
  --header "Authorization: Bearer gdc_..."

Cursor

Lisää Nodary tiedostoon ~/.cursor/mcp.json (kaikki projektit) tai .cursor/mcp.json (yksi projekti):
```
{
  "mcpServers": {
    "nodary": {
      "url": "https://nodary.ai/api/mcp"
    }
  }
}
```
Cursor tarjoaa kirjautumista, kun palvelin pyytää sitä ensimmäisen kerran.

Vaihtoehtoisesti API-avaimella

{
  "mcpServers": {
    "nodary": {
      "url": "https://nodary.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:NODARY_API_KEY}"
      }
    }
  }
}

VS Code (GitHub Copilot)

Lisää Nodary työtilasi tiedostoon .vscode/mcp.json tai suorita komento MCP: Add Server:

{
  "servers": {
    "nodary": {
      "type": "http",
      "url": "https://nodary.ai/api/mcp"
    }
  }
}

Käynnistä palvelin; VS Code avaa Nodaryn kirjautumisen.

Copilot Business- ja Enterprise-tilauksissa ylläpitäjän on ensin sallittava MCP-palvelimet.

Vaihtoehtoisesti API-avaimella

{
  "inputs": [
    {
      "type": "promptString",
      "id": "nodary-key",
      "description": "Nodary API key",
      "password": true
    }
  ],
  "servers": {
    "nodary": {
      "type": "http",
      "url": "https://nodary.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:nodary-key}"
      }
    }
  }
}

Devin Desktop (aiemmin Windsurf)

Lisää palvelin ja kirjaudu päätteestä:

devin mcp add -s user nodary https://nodary.ai/api/mcp
devin mcp login nodary

Tai lisää se tiedostoon ~/.config/devin/mcp_config.json (Windowsissa %APPDATA%\devin\mcp_config.json):

{
  "mcpServers": {
    "nodary": {
      "url": "https://nodary.ai/api/mcp",
      "transport": "http"
    }
  }
}

Jos jokin ei toimi

Jos ensimmäiseen pyyntöön vastataan 401 ja mukana on resource_metadata-osoite, kaikki on kunnossa: se kertoo asiakasohjelmalle, missä kirjaudutaan.
Jos pyyntö hylätään vastauksella quota_locked, työtila ylittää Free-tilauksen kokeilunsa jälkeen ja on lukittu, kunnes sille otetaan tilaus: heti kun omistaja tilaa, agentti toimii taas. Usean työtilan yhteydessä hylätään vain tähän työtilaan kohdistuvat kutsut.
Vastauksella workspace_required (tai workspace_not_found) hylätty kutsu luettelee työtilat, joihin yhteys ulottuu: anna yksi niistä workspace-arvona. Jos haluat ulottua työtilaan, joka ei ole luettelossa, yhdistä sovellus uudelleen ja valitse se.
Jos asiakasohjelma ei saa kirjautumista päätökseen, yhdistä se sen sijaan API-avaimella.