# Nodarys MCP-server

Nodary har en ekstern MCP-server, slik at en KI-agent leser og skriver i arbeidsområdet ditt slik en kollega gjør: samme dokumenter, samme tilganger, innlogget i ditt navn.

## Kort oppsummert

- **Adresse**: https://nodary.ai/api/mcp
- **Transport**: Streamable HTTP (JSON-RPC over POST)
- **Innlogging**: OAuth 2.1 med dynamisk klientregistrering og PKCE, eller en API-nøkkel
- **Tilgang**: Inkludert i alle planer; i Free innenfor grensene i planen
- **Oppdagelse**: https://nodary.ai/.well-known/oauth-protected-resource/api/mcp · https://nodary.ai/.well-known/mcp.json

Claude Code: Kjør denne kommandoen i en terminal (legg til --scope user for å bruke Nodary i alle prosjekter):

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

## Hva det er

Model Context Protocol (MCP) er den åpne standarden KI-klienter bruker for å jobbe med eksterne verktøy. Nodarys server gir en agent det samme arbeidsområdet som teamet ditt bruker: prosjekter, dokumenter og koblingene mellom dem, regneark, bilder, oversettelsestabeller, dialoger og tavler.

En agent får ingen kopi. Den leser det som finnes akkurat nå, skriver der du ber den om det, og hvert resultat har med lenken en person kan åpne for å kontrollere arbeidet.

## Innlogging

De fleste klienter logger inn med OAuth: gi dem serverens adresse, så åpner de en innloggings- og samtykkeside fra Nodary i nettleseren din. Nodary støtter OAuth 2.1 med dynamisk klientregistrering og PKCE, så du trenger ikke opprette noen klient-ID, og det er ingenting å kopiere. Tilgangstokener varer i én time, og klienten fornyer dem.

Én tilkobling kan nå flere arbeidsområder. Er du medlem av flere, viser samtykkesiden alle, avkrysset: appen når da arbeidsområdene du lar stå avkrysset, og bare dem. «Også arbeidsområdene jeg blir med i senere» er av med mindre du krysser det av. I en slik tilkobling tar hvert verktøy workspace (id, slug eller navn): et kall som endrer noe, må oppgi det, en lesing uten det kjører bare der ID-ene hører hjemme, og hvert resultat begynner med arbeidsområdet det kjørte i. En API-nøkkel forblir knyttet til ett arbeidsområde.

En klient som ikke kan logge inn, kan bruke en API-nøkkel i stedet: opprett en i profilen din, under API keys & MCP (den begynner med gdc_), og send den i headeren Authorization: Bearer gdc_… En nøkkel kan begrenses til ett prosjekt.

## Hvem kan bruke den

MCP-serveren er inkludert i alle planer, Free, Pro, Studio og Enterprise, for hvert medlem og uten ekstra kostnad.

I Free leser og skriver en agent som i en betalt plan så lenge arbeidsområdet holder seg innenfor planen: 1 prosjekt, 10 dokumenter og mapper samt 2 medlemmer. En skriving som ville gått over en grense, avvises med grensen den når og hvordan den oppheves: så lenge arbeidsområdet fortsatt kan få prøveperioden sin, lenken til oversikten der eieren eller en administrator starter prøveperioden for Studio på 14 dager (med MCP, uten kort); ellers lenken til prissiden.

Et arbeidsområde over Free-planen etter prøveperioden, uten abonnement, er låst til det abonnerer: agenter kobles fra der, også for lesing. En tilkobling til bare det arbeidsområdet får quota_locked på hver forespørsel, med det som er over grensen og hvor eieren abonnerer; en tilkobling til flere arbeidsområder får quota_locked (eller billing_locked etter en mislykket betaling) bare på kallene til det låste, som en verktøyfeil, og fortsetter å virke i de andre.

- [Priser](https://nodary.ai/nb/pricing)

## Hva en agent kan gjøre

92 verktøy, gruppert her etter jobben de gjør. Hvert av dem forteller klienten om det bare leser, og om en skriving kan overskrive noe, slik at klienten kan spørre deg før den handler.

### Finn og les

Prosjekter, dokumenter med koblinger og historikk, kommentarer, kunnskapsnotater, lagrede visninger og kontekstunderlag. Resultatene har lenker folk kan åpne.

`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`

### Skriv og organiser

Opprett og rediger dokumenter blokk for blokk, legg dem i mapper, koble dem, gi dem etiketter, kommenter, sett egenskaper og løs motsigelser. Et slettet dokument kan gjenopprettes.

`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`

### Kunstgjennomgang og bilder

Hent inn bilder, se på dem sammen med notatene folk har tegnet på dem, ta avgjørelser, noter og merk leveranser (hver avgjørelse signert med hvem og når), gjør et moodboard om til en palett og sjekk et bilde mot den, og lag et tilbakemeldingsark til en ekstern leverandør.

`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`

### Regneark og balansering

Les et ark som beregnede verdier med formelen bak hver celle, skriv celler etter adresse eller rad, og les en byttetabell for hva den betyr for spillerne.

`get_sheet`, `set_cells`, `analyze_drops`

### Lokalisering og dialog

Se fremdriften for hvert språk i en oversettelsestabell, skriv oversettelser etter nøkkel, og sjekk en forgrenet dialog, som eksporteres som et Yarn Spinner-skript.

`get_localization`, `set_translations`, `check_dialogue`

### Produksjon

Sett frister, be om og send inn gjennomganger, se hva som er endret nylig, og om milepælen holder.

`get_progress`, `recent_changes`, `set_due_date`, `set_due_dates`, `request_review`, `submit_review`

## Ledetekster og ressurser

Ferdige forespørsler en klient kan tilby som kommandoer:

- weekly-summary: Hva som er endret denne uken i arbeidsområdet eller i ett prosjekt: skrevet, avgjort, gjennomgått og fortsatt åpent.
- art-review: Hvor kunstgjennomgangen står: bilder som venter på en avgjørelse, de som avviker fra paletten, og hva som bør avgjøres nå.
- playtest-to-tasks: Gjør notater fra spilltester om til oppgaver, hver koblet til designdokumentet den berører.
- balance-review: Leser en byttetabell eller en progresjonskurve og forteller hva den betyr for spillerne, og hva som ser feil ut.

Ressurser en klient kan legge ved uten et verktøykall:

- nodary://star/{id}: et dokument, som Markdown
- nodary://project/{id}: et prosjekts disposisjon

## Sikkerhet

- En agent handler som personen som koblet den til: den ser og endrer bare det den personen kan, og en nøkkel som er begrenset til et prosjekt, holder seg i det prosjektet.
- I en tilkobling til flere arbeidsområder løses ingenting opp på tvers av dem: ID-er og titler slås bare opp i arbeidsområdet kallet oppgir, en ID fra et annet arbeidsområde avvises før noe kjører, og hvert resultat oppgir arbeidsområdet sitt.
- Dokumentene beholder versjonshistorikken sin, og et slettet dokument kan gjenopprettes.
- Skriveverktøy tar en idempotensnøkkel: et kall som sendes på nytt etter en brutt forbindelse, returnerer det første resultatet i stedet for å skrive to ganger.
- En tilkobling gjør høyst 120 forespørsler i minuttet; skriving har ingen daglig grense.
- Avgjørelser i kunstgjennomgangen signeres med navnet på personen som tok dem, og tidspunktet.
- Nodary sier til hver agent at teksten i dokumenter og kommentarer er innhold å jobbe med, ikke instruksjoner å følge. Hvordan en agent handler ut fra det, er opp til agenten.

## Koble til klienten din

Bruk adressen https://nodary.ai/api/mcp. Hver klient nedenfor ble kontrollert mot sin egen dokumentasjon 1. oktober 2026.

### Claude (claude.ai og Claude Desktop)

1. Åpne Customize, deretter Connectors, og velg Add custom connector.
2. Skriv inn https://nodary.ai/api/mcp. Når Claude spør hvordan klienten skal registreres, velger du Register automatically.
3. Koble til, logg inn på Nodary og godkjenn tilgangen.

Egendefinerte koblinger (custom connectors) er tilgjengelige på planene Free, Pro, Max, Team og Enterprise; en Free-konto kan legge til én. På Team og Enterprise må en eier først legge til koblingen for organisasjonen.

### ChatGPT

1. I Settings, under Security and login, slår du på Developer mode.
2. Opprett en app for en ekstern MCP-server med adressen https://nodary.ai/api/mcp og OAuth-innlogging.
3. Logg inn på Nodary og godkjenn tilgangen. Verktøyene vises deretter i Developer mode i meldingsfeltet.

Developer mode er tilgjengelig på nett for Plus-, Pro-, Business-, Enterprise- og Education-kontoer; på Business og Enterprise kan en administrator måtte tillate det. ChatGPT kobler seg bare til med OAuth, ikke med en API-nøkkel.

### Claude Code

1. Kjør denne kommandoen i en terminal (legg til --scope user for å bruke Nodary i alle prosjekter):

   ```
   claude mcp add --transport http nodary https://nodary.ai/api/mcp
   ```
2. Skriv /mcp i Claude Code, velg nodary og logg inn fra nettleseren.

Med en API-nøkkel i stedet

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

### Cursor

1. Legg Nodary til i ~/.cursor/mcp.json (alle prosjekter) eller .cursor/mcp.json (ett prosjekt):

   ```
   {
     "mcpServers": {
       "nodary": {
         "url": "https://nodary.ai/api/mcp"
       }
     }
   }
   ```
2. Cursor tilbyr innlogging første gang serveren ber om det.

Med en API-nøkkel i stedet

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

### VS Code (GitHub Copilot)

1. Legg Nodary til i .vscode/mcp.json i VS Code-arbeidsområdet ditt, eller kjør kommandoen MCP: Add Server:

   ```
   {
     "servers": {
       "nodary": {
         "type": "http",
         "url": "https://nodary.ai/api/mcp"
       }
     }
   }
   ```
2. Start serveren; VS Code åpner innloggingen til Nodary.

På Copilot Business og Enterprise må en administrator først tillate MCP-servere.

Med en API-nøkkel i stedet

```json
{
  "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 (tidligere Windsurf)

1. Legg til serveren og logg inn fra en terminal:

   ```
   devin mcp add -s user nodary https://nodary.ai/api/mcp
   devin mcp login nodary
   ```
2. Eller legg den til i ~/.config/devin/mcp_config.json (på Windows %APPDATA%\devin\mcp_config.json):

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

## Hvis noe ikke virker

- Får den første forespørselen svaret 401 med en resource_metadata-adresse, er det som forventet: svaret forteller klienten hvor den skal logge inn.
- En forespørsel som avvises med quota_locked, betyr at arbeidsområdet er over Free-planen etter prøveperioden og er låst til det abonnerer: så snart eieren abonnerer, virker agenten igjen. I en tilkobling til flere arbeidsområder avvises bare kallene til det arbeidsområdet.
- Et kall som avvises med workspace_required (eller workspace_not_found), lister opp arbeidsområdene tilkoblingen når: oppgi ett av dem som workspace. For å nå et arbeidsområde som ikke er på listen, koble til appen på nytt og kryss det av.
- Hvis en klient ikke klarer å fullføre innloggingen, kobler du den til med en API-nøkkel i stedet.

https://nodary.ai/nb/docs/mcp