# Der MCP-Server von Nodary

Nodary betreibt einen Remote-MCP-Server: Ein KI-Agent liest und schreibt in Ihrem Arbeitsbereich wie ein Teammitglied, mit denselben Dokumenten, denselben Berechtigungen und angemeldet in Ihrem Namen.

## Auf einen Blick

- **Adresse**: https://nodary.ai/api/mcp
- **Transport**: Streamable HTTP (JSON-RPC über POST)
- **Anmeldung**: OAuth 2.1 mit dynamischer Client-Registrierung und PKCE, oder ein API-Schlüssel
- **Zugang**: In jedem Tarif enthalten; in Free innerhalb der Grenzen des Tarifs
- **Erkennung**: https://nodary.ai/.well-known/oauth-protected-resource/api/mcp · https://nodary.ai/.well-known/mcp.json

Claude Code: Führen Sie diesen Befehl in einem Terminal aus (mit --scope user nutzen Sie Nodary in jedem Projekt):

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

## Worum es geht

Das Model Context Protocol (MCP) ist der offene Standard, über den KI-Clients mit externen Werkzeugen arbeiten. Der Server von Nodary gibt einem Agenten denselben Arbeitsbereich, den Ihr Team nutzt: Projekte, Dokumente und ihre Verknüpfungen, Tabellen, Bilder, Übersetzungstabellen, Dialoge und Boards.

Ein Agent erhält keine Kopie. Er liest, was gerade da ist, schreibt dort, wo Sie es verlangen, und jedes Ergebnis enthält den Link, über den ein Mensch seine Arbeit prüfen kann.

## Anmeldung

Die meisten Clients melden sich per OAuth an: Geben Sie ihnen die Adresse des Servers, und sie öffnen in Ihrem Browser eine Anmelde- und Zustimmungsseite von Nodary. Nodary unterstützt OAuth 2.1 mit dynamischer Client-Registrierung und PKCE, Sie müssen also keine Client-ID anlegen und nichts kopieren. Zugriffstoken gelten eine Stunde, und der Client erneuert sie.

Eine Verbindung kann mehrere Arbeitsbereiche erreichen. Wenn Sie Mitglied in mehreren sind, listet die Zustimmungsseite sie alle auf, angekreuzt: Die App erreicht dann die Arbeitsbereiche, die angekreuzt bleiben, und nur diese. „Auch die Arbeitsbereiche, denen ich später beitrete“ bleibt aus, solange Sie es nicht ankreuzen. In einer solchen Verbindung nimmt jedes Tool workspace an (ID, Slug oder Name): Ein Aufruf, der etwas ändert, muss ihn nennen, ein Lesezugriff ohne ihn läuft nur dort, wo seine IDs liegen, und jedes Ergebnis beginnt mit dem Arbeitsbereich, in dem es lief. Ein API-Schlüssel bleibt an einen Arbeitsbereich gebunden.

Ein Client, der sich nicht anmelden kann, nutzt stattdessen einen API-Schlüssel: Legen Sie ihn in Ihrem Profil unter API keys & MCP an (er beginnt mit gdc_) und senden Sie ihn im Header Authorization: Bearer gdc_… Ein Schlüssel kann auf ein Projekt beschränkt werden.

## Wer ihn nutzen kann

Der MCP-Server ist in jedem Tarif enthalten, Free, Pro, Studio und Enterprise, für jedes Mitglied und ohne Aufpreis.

In Free liest und schreibt ein Agent wie in einem kostenpflichtigen Tarif, solange der Arbeitsbereich innerhalb des Tarifs bleibt: 1 Projekt, 10 Dokumente und Ordner sowie 2 Mitglieder. Ein Schreibvorgang, der ein Limit überschreiten würde, wird mit dem erreichten Limit abgelehnt und mit dem Weg, es aufzuheben: solange der Arbeitsbereich seine Testphase noch haben kann, der Link zum Dashboard, wo der Inhaber oder ein Administrator die 14-tägige Studio-Testphase startet (mit MCP, ohne Karte); sonst der Link zur Preisseite.

Ein Arbeitsbereich oberhalb des Free-Tarifs nach seiner Testphase, ohne Abo, ist gesperrt, bis er ein Abo hat: Agenten sind dort abgeschaltet, auch beim Lesen. Eine Verbindung zu nur diesem Arbeitsbereich erhält bei jeder Anfrage quota_locked, mit dem, was über dem Limit liegt, und wo der Inhaber abonniert; eine Verbindung zu mehreren Arbeitsbereichen erhält quota_locked (oder nach einer fehlgeschlagenen Zahlung billing_locked) nur bei Aufrufen in den gesperrten, als Tool-Fehler, und arbeitet in den anderen weiter.

- [Preise](https://nodary.ai/de/pricing)

## Was ein Agent tun kann

92 Tools, hier nach ihrer Aufgabe gruppiert. Jedes teilt dem Client mit, ob es nur liest und ob ein Schreibvorgang etwas überschreiben kann, damit der Client Sie fragen kann, bevor er handelt.

### Finden und lesen

Projekte, Dokumente mit ihren Verknüpfungen und ihrem Verlauf, Kommentare, Wissensnotizen, gespeicherte Ansichten und Kontext-Briefings. Die Ergebnisse enthalten Links, die Menschen öffnen können.

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

### Schreiben und ordnen

Dokumente Block für Block erstellen und bearbeiten, in Ordnern ablegen, verknüpfen, verschlagworten, kommentieren, Eigenschaften setzen und Widersprüche auflösen. Ein gelöschtes Dokument lässt sich wiederherstellen.

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

### Art-Review und Bilder

Bilder hereinholen, sie mit den Notizen ansehen, die Menschen daraufgezeichnet haben, über Lieferungen entscheiden, sie mit Notizen und Schlagwörtern versehen (jede Entscheidung signiert mit Name und Zeitpunkt), aus einem Moodboard eine Palette machen und ein Bild daran prüfen sowie ein Feedback-Blatt für einen externen Dienstleister vorbereiten.

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

### Tabellen und Balancing

Eine Tabelle als berechnete Werte lesen, mit der Formel hinter jeder Zelle, Zellen per Adresse oder zeilenweise schreiben und eine Beutetabelle darauf lesen, was sie für Spieler bedeutet.

`get_sheet`, `set_cells`, `analyze_drops`

### Lokalisierung und Dialoge

Den Fortschritt jeder Sprache in einer Übersetzungstabelle sehen, Übersetzungen per Schlüssel schreiben und einen verzweigten Dialog prüfen, der sich als Skript für Yarn Spinner exportieren lässt.

`get_localization`, `set_translations`, `check_dialogue`

### Produktion

Fälligkeitsdaten setzen, Prüfungen anfordern und Prüfentscheidungen abgeben, sehen, was sich zuletzt geändert hat und ob der Meilenstein zu halten ist.

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

## Prompts und Ressourcen

Vorgefertigte Anfragen, die ein Client als Befehle anbieten kann:

- weekly-summary: Was sich diese Woche im Arbeitsbereich oder in einem Projekt getan hat: geschrieben, entschieden, geprüft und noch offen.
- art-review: Wo das Art-Review steht: Bilder, die auf eine Entscheidung warten, solche, die von der Palette abweichen, und was als Nächstes zu entscheiden ist.
- playtest-to-tasks: Macht aus Playtest-Notizen Aufgaben, jede verknüpft mit dem Designdokument, das sie betrifft.
- balance-review: Liest eine Beutetabelle oder eine Progressionskurve und sagt, was sie für Spieler bedeutet und was nicht stimmig wirkt.

Ressourcen, die ein Client ohne Tool-Aufruf anhängen kann:

- nodary://star/{id}: ein Dokument, als Markdown
- nodary://project/{id}: die Gliederung eines Projekts

## Sicherheit

- Ein Agent handelt als die Person, die ihn verbunden hat: Er sieht und ändert nur, was diese Person darf, und ein auf ein Projekt beschränkter Schlüssel bleibt in diesem Projekt.
- In einer Verbindung zu mehreren Arbeitsbereichen wird nichts über Arbeitsbereiche hinweg aufgelöst: IDs und Titel werden nur in dem Arbeitsbereich gesucht, den der Aufruf nennt, eine ID aus einem anderen Arbeitsbereich wird abgelehnt, bevor etwas läuft, und jedes Ergebnis nennt seinen Arbeitsbereich.
- Dokumente behalten ihren Versionsverlauf, und ein gelöschtes Dokument lässt sich wiederherstellen.
- Schreibende Tools nehmen einen Idempotenzschlüssel an: Ein Aufruf, der nach einem Verbindungsabbruch wiederholt wird, liefert das erste Ergebnis zurück, statt doppelt zu schreiben.
- Eine Verbindung stellt höchstens 120 Anfragen pro Minute; für das Schreiben gibt es kein Tageslimit.
- Entscheidungen im Art-Review werden mit dem Namen der Person, die sie getroffen hat, und dem Zeitpunkt signiert.
- Nodary teilt jedem Agenten mit, dass der Text von Dokumenten und Kommentaren Inhalt ist, mit dem er arbeitet, und keine Anweisung, der er folgen soll. Wie ein Agent damit umgeht, liegt beim Agenten selbst.

## Ihren Client verbinden

Verwenden Sie die Adresse https://nodary.ai/api/mcp. Jeder der folgenden Clients wurde am 1. Oktober 2026 anhand seiner eigenen Dokumentation geprüft.

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

1. Öffnen Sie Customize, dann Connectors, und wählen Sie Add custom connector.
2. Geben Sie https://nodary.ai/api/mcp ein. Wenn Claude fragt, wie die Registrierung erfolgen soll, wählen Sie Register automatically.
3. Wählen Sie Connect, melden Sie sich bei Nodary an und genehmigen Sie den Zugriff.

Benutzerdefinierte Connectors gibt es in den Tarifen Free, Pro, Max, Team und Enterprise; auch ein Free-Konto kann einen hinzufügen. Bei Team und Enterprise fügt zuerst ein Inhaber den Connector für die Organisation hinzu.

### ChatGPT

1. Schalten Sie in den Settings unter Security and login den Developer mode ein.
2. Erstellen Sie eine App für einen Remote-MCP-Server mit der Adresse https://nodary.ai/api/mcp und OAuth-Anmeldung.
3. Melden Sie sich bei Nodary an und genehmigen Sie den Zugriff. Die Tools erscheinen dann im Developer mode des Eingabefelds.

Der Developer mode ist im Web für Konten mit Plus, Pro, Business, Enterprise und Education verfügbar; bei Business und Enterprise muss ihn eventuell ein Admin freigeben. ChatGPT verbindet sich nur per OAuth, nicht mit einem API-Schlüssel.

### Claude Code

1. Führen Sie diesen Befehl in einem Terminal aus (mit --scope user nutzen Sie Nodary in jedem Projekt):

   ```
   claude mcp add --transport http nodary https://nodary.ai/api/mcp
   ```
2. Geben Sie in Claude Code /mcp ein, wählen Sie nodary und melden Sie sich im Browser an.

Stattdessen mit einem API-Schlüssel

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

### Cursor

1. Tragen Sie Nodary in ~/.cursor/mcp.json (alle Projekte) oder .cursor/mcp.json (ein Projekt) ein:

   ```
   {
     "mcpServers": {
       "nodary": {
         "url": "https://nodary.ai/api/mcp"
       }
     }
   }
   ```
2. Cursor bietet die Anmeldung an, sobald der Server zum ersten Mal danach fragt.

Stattdessen mit einem API-Schlüssel

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

### VS Code (GitHub Copilot)

1. Tragen Sie Nodary in .vscode/mcp.json Ihres Arbeitsbereichs ein oder führen Sie den Befehl MCP: Add Server aus:

   ```
   {
     "servers": {
       "nodary": {
         "type": "http",
         "url": "https://nodary.ai/api/mcp"
       }
     }
   }
   ```
2. Starten Sie den Server; VS Code öffnet die Anmeldung bei Nodary.

Bei Copilot Business und Enterprise muss ein Admin MCP-Server zuerst zulassen.

Stattdessen mit einem API-Schlüssel

```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 (früher Windsurf)

1. Fügen Sie den Server hinzu und melden Sie sich in einem Terminal an:

   ```
   devin mcp add -s user nodary https://nodary.ai/api/mcp
   devin mcp login nodary
   ```
2. Oder tragen Sie ihn in ~/.config/devin/mcp_config.json ein (unter Windows %APPDATA%\devin\mcp_config.json):

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

## Wenn etwas nicht funktioniert

- Eine erste Anfrage, die mit 401 und einer resource_metadata-Adresse beantwortet wird, ist normal: Sie zeigt dem Client, wo er sich anmelden kann.
- Wird eine Anfrage mit quota_locked abgelehnt, liegt der Arbeitsbereich nach seiner Testphase über dem Free-Tarif und ist gesperrt, bis er ein Abo hat: Sobald der Inhaber abonniert, arbeitet der Agent wieder. In einer Verbindung zu mehreren Arbeitsbereichen werden nur die Aufrufe in diesen Arbeitsbereich abgelehnt.
- Ein Aufruf, der mit workspace_required (oder workspace_not_found) abgelehnt wird, listet die Arbeitsbereiche auf, die die Verbindung erreicht: Übergeben Sie einen davon als workspace. Um einen Arbeitsbereich zu erreichen, der nicht in der Liste steht, verbinden Sie die App erneut und kreuzen Sie ihn an.
- Wenn ein Client die Anmeldung nicht abschließen kann, verbinden Sie ihn stattdessen mit einem API-Schlüssel.

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