# VS Code mit Nodary verbinden

Der Agent von GitHub Copilot in VS Code kann die Spezifikationen und Entscheidungen Ihres Teams in Nodary lesen und zurückschreiben, mit Ihren Berechtigungen.

Am 22. Oktober 2026 mit der Dokumentation jedes Anbieters abgeglichen.

## Bevor Sie beginnen

- VS Code mit GitHub Copilot. Bei Copilot Free, Pro, Pro+ und Max regelt keine Organisationsrichtlinie die MCP-Server.
- Bei Copilot Business und Enterprise muss die Richtlinie MCP servers in Copilot der Organisation aktiviert sein; standardmäßig ist sie aus. Eine Zulassungsliste des Unternehmens kann zudem begrenzen, welche Server Sie hinzufügen dürfen.
- Ein Nodary-Konto. Der MCP-Server ist in jedem Tarif enthalten; bei Free, solange der Arbeitsbereich in den Grenzen des Tarifs bleibt: 1 Projekt, 10 Dokumente und Ordner, 2 Mitglieder. Copilot verbraucht keine Kometen: Es nutzt sein eigenes Modell.

Noch kein Arbeitsbereich? Erstellen Sie einen und kommen Sie dann zum Verbinden zurück. [Kostenlosen Arbeitsbereich erstellen](https://nodary.ai/sign-up)

## Nodary hinzufügen

1. Öffnen Sie die Befehlspalette (Strg+Umschalt+P, oder Cmd+Umschalt+P auf dem Mac) und führen Sie MCP: Add Server aus.
2. Wählen Sie HTTP (HTTP or Server-Sent Events) und geben Sie die Serveradresse ein:

   ```
   https://nodary.ai/api/mcp
   ```
3. Geben Sie nodary als Server-ID ein.
4. Wählen Sie Global, dann Copilot Global, um Nodary in jedem Arbeitsbereich zu nutzen. VS Code schreibt es nach ~/.copilot/mcp-config.json:

   ```
   {
     "mcpServers": {
       "nodary": {
         "type": "http",
         "url": "https://nodary.ai/api/mcp",
         "tools": [
           "*"
         ]
       }
     }
   }
   ```
5. Wenn der Server startet, nehmen Sie die Vertrauens- und Anmeldeabfragen an: Die Zustimmungsseite von Nodary öffnet sich in Ihrem Browser.

**Ältere Konfigurationen:** VS Code liest weiterhin .vscode/mcp.json und die mcp.json Ihres Benutzerprofils, die servers statt mcpServers verwenden, und kennzeichnet sie als veraltet.

## Anmelden und Arbeitsbereiche wählen

Die Zustimmungsseite von Nodary nennt die App, die fragt, und die Adresse, an die sie zurückgeschickt wird. Melden Sie sich an, falls nötig, und wählen Sie die Arbeitsbereiche, die Copilot erreichen darf: Bei einem Arbeitsbereich wählen Sie ihn aus, bei mehreren ist keiner vorab angehakt, haken Sie also jeden an, den Copilot nutzen darf. Liegt Ihre Anmeldung mehr als 10 Minuten zurück, fragt Nodary erneut nach Ihrem Passwort. Stimmen Sie zu, und der Browser bringt Sie zurück zu Copilot.

Copilot handelt dann als Sie: Es sieht und ändert nur, was Ihre Rolle erlaubt, in den angehakten Arbeitsbereichen. Sein Zugriff gilt jeweils 60 Minuten, und Copilot erneuert ihn selbst.

## Nodary in Copilot Chat verwenden

Prüfen Sie in Copilot Chat, ob die Tools von Nodary eingeschaltet sind (Configure Tools, oder Chat: Open Customizations, dann Tools), und fragen Sie dann in normalen Worten. Ein paar Anfragen für den Anfang:

- Lies das API-Designdokument in Nodary und prüfe diesen Endpunkt dagegen.
- Schreib eine Architekturentscheidung (ADR) für den Wechsel zu Postgres, lege sie unter Architektur ab und verlinke sie mit der Spezifikation.
- Welche Dokumente im Projekt Backend sind noch Entwürfe, und wer ist dafür zuständig?

## Stattdessen mit einem API-Schlüssel

Fügen Sie den Header in ~/.copilot/mcp-config.json ein, eine Datei in Ihrem Home-Ordner, die Sie nie einchecken:

```json
{
  "mcpServers": {
    "nodary": {
      "type": "http",
      "url": "https://nodary.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer gdc_..."
      },
      "tools": [
        "*"
      ]
    }
  }
}
```

**Im Klartext:** VS Code liest aus dieser Datei keine abgefragten Variablen, der Schlüssel steht also so darin, wie Sie ihn eintragen. Geben Sie ihm eine Laufzeit von 30 oder 90 Tagen und widerrufen Sie ihn in Nodary, wenn der Rechner verloren geht.

Erstellen Sie den Schlüssel in Nodary unter Profil, API-Schlüssel und MCP. Er beginnt mit gdc_, wird nur einmal angezeigt, handelt mit Ihren Berechtigungen, lässt sich auf ein Projekt beschränken und läuft nach 30, 90 oder 365 Tagen ab, oder nie, wie Sie wählen.

![Der Bereich API-Schlüssel und MCP eines Nodary-Profils: die Adresse des MCP-Servers zum Einfügen in einen KI-Client und ein Agentenschlüssel mit seinem Geltungsbereich.](https://nodary.ai/marketing/mcp-connect.webp)

## Wenn etwas nicht funktioniert

- VS Code meldet, dass eine Unternehmensbeschränkung den Server blockiert: Fragen Sie Ihren Administrator nach der Richtlinie MCP servers in Copilot und der Zulassungsliste des Unternehmens.
- Es erscheint keine Anmeldung: Führen Sie MCP: List Servers aus, starten Sie nodary neu und nehmen Sie die Abfragen an. Wird die Anmeldung trotzdem nicht abgeschlossen, nutzen Sie einen API-Schlüssel.
- Eine erste Anfrage mit der Antwort 401 ist normal: Sie sagt dem Client, wo er sich anmelden soll.
- quota_locked: Der Arbeitsbereich liegt nach seiner Testphase über dem Free-Tarif und ist gesperrt, bis der Inhaber ein Abo abschließt. Danach funktioniert alles sofort wieder.
- billing_locked: Eine Zahlung ist fehlgeschlagen, daher ist der Arbeitsbereich gesperrt, bis der Inhaber sie in der Abrechnung des Arbeitsbereichs begleicht. Sobald die Zahlung durch ist, funktioniert alles wieder.
- workspace_suspended: Nodary hat den Arbeitsbereich gesperrt, nichts erreicht ihn mehr, auch keine Agenten. Der Inhaber kann an support@nodary.ai schreiben.
- workspace_required: Die Verbindung erreicht mehrere Arbeitsbereiche, nennen Sie also den, in dem gearbeitet werden soll, oder verbinden Sie sich neu und haken Sie nur einen an.

## Fragen

### Kostet es etwas, Copilot zu verbinden?

Nicht auf Seiten von Nodary. Der MCP-Server ist in jedem Tarif enthalten, Free in seinen Grenzen, und Copilot verbraucht keine Kometen: Kometen zählen nur die Studio-KI. Ihr Copilot-Tarif entscheidet, ob Sie den Server hinzufügen können.

### Copilot Business meldet, dass MCP-Server ausgeschaltet sind. Was tun?

Ein Admin der Organisation oder des Unternehmens aktiviert die Richtlinie MCP servers in Copilot, die standardmäßig aus ist. Copilot Free, Pro, Pro+ und Max unterliegen ihr nicht.

### Muss ich Node.js oder etwas anderes installieren?

Nein. Nodary ist ein Remote-Server: VS Code spricht über HTTPS mit ihm, und auf Ihrem Rechner läuft nichts.

### Kann Copilot meine Dokumente löschen oder überschreiben?

Nur wo Ihre Rolle es erlaubt, und eine Änderung lässt sich zurücknehmen: Jede Bearbeitungssitzung von höchstens zehn Minuten ergibt eine Version, ebenso jeder Schreibvorgang eines Agenten. Ein Dokument behält seine 50 neuesten Versionen von Menschen und seine 50 neuesten von Agenten (die der Agenten verdrängen nie die der Menschen), die Sie vergleichen und wiederherstellen, und ein gelöschtes Dokument kommt 30 Tage lang zurück. Freigabelinks, Zugriffe, Mitglieder, Rollen, Schlüssel, Abrechnung und das Löschen eines Projekts bleiben menschliche Entscheidungen: Kein Agent kann sie treffen.

### Wie trenne ich die Verbindung?

Öffnen Sie in Nodary Profil, Sicherheit, Verbundene Apps und trennen Sie die App: Sie stoppt sofort. Entfernen Sie in VS Code nodary aus ~/.copilot/mcp-config.json oder stoppen Sie es über MCP: List Servers. Ein Schlüssel wird unter Profil, API-Schlüssel und MCP widerrufen, und Inhaber und Admins können jeden Schlüssel des Arbeitsbereichs in dessen Einstellungen unter MCP widerrufen.

### Nutzt Nodary meine Dokumente, um KI zu trainieren?

Nein. Nodary nutzt die Inhalte von Arbeitsbereichen nicht zum Training von KI-Modellen. Was Copilot mit dem Gelesenen macht, regeln die Bedingungen seines Herstellers.

## Weiterlesen

- [Cursor mit Nodary verbinden](https://nodary.ai/de/docs/mcp/cursor): Tragen Sie Nodary in die mcp.json von Cursor ein und melden Sie sich dann in Cursor an.
- [Claude Code mit Nodary verbinden](https://nodary.ai/de/docs/mcp/claude-code): Ein Befehl fügt Nodary zu Claude Code hinzu, dann meldet /mcp Sie an.
- [Der MCP-Server von Nodary](https://nodary.ai/de/docs/mcp): Der Server, die Anmeldung, die 98 Tools, die Sicherheit und alle Clients auf einen Blick.
- [MCP (Model Context Protocol)](https://nodary.ai/de/glossary/model-context-protocol): Das Model Context Protocol (MCP) ist ein offener Standard, der KI-Anwendungen über eine gemeinsame Schnittstelle mit externen Werkzeugen und Daten verbindet.
- [OAuth](https://nodary.ai/de/glossary/oauth): OAuth ist ein Standard, mit dem eine App in einem anderen Dienst für Sie handelt, mit dem Zugriff, den Sie erlauben, ohne je Ihr Passwort zu sehen.

https://nodary.ai/de/docs/mcp/vs-code