Erste Schritte

Agent verbinden

Claude Code, Cursor, Codex oder VS Code über MCP mit nyxory verbinden. Ein Endpunkt, OAuth beim ersten Verbinden, kein Token zum Einfügen.

MCP (Model Context Protocol) ist die definierte Schnittstelle zwischen Ihrem Coding-Agenten und nyxory. Jeder Client, der MCP spricht, lässt sich anschließen. Es gibt einen Endpunkt und einen Anmeldeweg, und jeder Client braucht einen kleinen Schritt, um ihn einzutragen.

Endpunkt: https://api.nyxory.com/mcp (Streamable HTTP)
Authentifizierung: OAuth beim ersten Verbinden. Der Client öffnet einen Browser, und ein Mensch gibt frei. Für die interaktive Nutzung müssen Sie kein Token erzeugen oder einfügen.

Hinweis: Neue Konten schaltet das nyxory-Team frei. Bis Ihr Konto freigeschaltet ist, gibt jeder Tool-Aufruf approval_pending zurück („your account is awaiting approval“). Auf Ihrer Seite ist nichts zu beheben. Dieselbe Einrichtung funktioniert, sobald das Konto freigeschaltet ist.

Jeder Coding-Agent, der MCP spricht, funktioniert. Springen Sie zu Ihrem:

Claude Codenyx claude install Cursornyx cursor install Codexnyx codex install VS Codenyx vscode install Claude Desktopüber claude.ai Jeder MCP-ClientHTTP-Endpunkt

Der schnellste Weg: `nyx setup`

Ein Befehl installiert die CLI nyx, meldet Sie an, erkennt die MCP-fähigen Clients auf dem Rechner (Claude Code, Cursor, Codex, VS Code, Claude Desktop) und trägt nyxory in jedem davon ein.

curl -fsSL https://nyxory.com/install.sh | bash    # macOS / Linux / WSL
irm https://nyxory.com/install.ps1 | iex           # Windows PowerShell

Der Installer führt nyx setup für Sie aus. Sie können den Befehl später erneut ausführen. Er ist idempotent und lässt Ihre anderen MCP-Server unverändert:

nyx setup            # pick the clients to wire, interactively
nyx setup --all      # wire every detected client, no prompts

Einen bestimmten Client verbinden

Wenn Sie nur einen Editor nutzen, tragen Sie nyxory direkt dort ein. Jeder der folgenden Befehle schreibt die Konfiguration des Clients an dessen eigenen Pfad. Sie bearbeiten nie eine Konfigurationsdatei von Hand.

Claude Code

nyx claude install

Das ruft die CLI von Claude Code selbst auf (claude mcp add) und trägt nyxory als entfernten HTTP-Endpunkt ein. Ohne nyx geht es so:

claude mcp add --transport http --scope user nyxory https://api.nyxory.com/mcp

Cursor

nyx cursor install

Schreibt den nyxory-Server in ~/.cursor/mcp.json (oder mit --scope local in ./.cursor/mcp.json) und ergänzt ihn neben den Servern, die dort schon eingetragen sind.

Codex

nyx codex install

Fügt einen Block [mcp_servers.nyxory] in ~/.codex/config.toml ein und führt dann codex mcp login nyxory aus, um OAuth abzuschließen. Codex fragt von sich aus nicht danach, deshalb ist dieser Schritt nötig.

VS Code

nyx vscode install

Schreibt einen Eintrag mit Transport http in die benutzerweite mcp.json von VS Code (~/Library/Application Support/Code/User/mcp.json unter macOS, %APPDATA%\Code\User\mcp.json unter Windows, ~/.config/Code/User/mcp.json unter Linux).

Claude Desktop

Claude Desktop verbindet sich über Ihr claude.ai-Konto, nicht über eine lokale Datei. Führen Sie nyx setup aus, dann öffnet sich die Seite mit den Connectors. Oder legen Sie selbst einen Custom Connector an, der auf https://api.nyxory.com/mcp zeigt.

Jeder andere MCP-Client

nyxory spricht Standard-MCP über HTTP. Richten Sie Ihren Client auf den Endpunkt:

{
  "mcpServers": {
    "nyxory": {
      "url": "https://api.nyxory.com/mcp"
    }
  }
}

Ein Aufruf von tools/list liefert den verbindlichen Funktionsumfang. Die Tools sind in der MCP-Tools aufgeführt, die Grundbausteine für Workspace und Build beschreibt Builds und die Ausführungsumgebung.

Authentifizierung

Interaktive Setups brauchen kein Token. Jeder Client führt beim ersten Verbinden seinen eigenen OAuth-Handshake mit dem Endpunkt aus, und ein Mensch gibt im Browser frei.

Für den Einsatz headless oder in CI erzeugen Sie auf einem angemeldeten Rechner ein langlebiges Token und senden es als Bearer-Token:

nyx token create my-ci-runner
# → prints the plaintext ONCE — store it as a secret

Zum Rotieren führen Sie nyx token delete <id> aus und danach erneut create. Alle Befehle unter nyx token stehen in der nyx-CLI-Referenz.

Verbindung prüfen

Bitten Sie Ihren Agenten, nyx_project_list aufzurufen. Das Tool liefert Ihr Konto, Ihre Workspaces und Projekte und bestätigt damit, dass der OAuth-Ablauf funktioniert hat. Die vollständige Liste der Tools steht in der MCP-Tools.

Gehen Sie als Nächstes den Schnellstart durch. Sie rollen private GitHub-Repos aus? Dafür installieren Sie einmalig die GitHub App, siehe Aus einem privaten Repo ausrollen.

Achtung: Wenn keine Verbindung zustande kommt, liegt es meist an einer von drei Ursachen. Falsche URL. Richtig ist api.nyxory.com/mcp, nicht api.nyxory.app (dort laufen die ausgerollten Apps). OAuth nicht abgeschlossen. Prüfen Sie bei Codex, ob codex mcp login nyxory im Browser abgeschlossen wurde. Bei den anderen Clients öffnen Sie den Client neu, damit er die Freigabe erneut anstößt. MCP-Transport deaktiviert. Prüfen Sie, ob MCP in den Einstellungen Ihres Clients aktiviert ist.