Clients verbinden

Überblick

Verbinden Sie Claude, ChatGPT Desktop, Codex, Cursor oder VS Code. Normalerweise eignet sich Remote ohne Installation und Schlüsselverwaltung; Local für lokale Dateien oder Headless-Umgebungen.

Verbindung wählen

Entscheiden Sie nach Umgebung und Bedarf an lokalen Dateien.

Methode	Einsatz	Authentifizierung	Installation
Remote MCP	Gewohnte KI-Clients	Browser-OAuth	Keine
Local MCP	Headless oder lokale Dateien	NoimosAI-Schlüssel	Node.js und npm-Paket

Remote unterstützt upload_media, upload_website_source und download_creation mit lokalem Dateizugriff nicht. Verwenden Sie dafür Local.

Mit Remote verbinden

Registrieren Sie den NoimosAI-Endpunkt und erlauben Sie Zugriff im Browser. Bereiten Sie Folgendes vor:

NoimosAI-Konto
MCP-Client mit Streamable HTTP und OAuth

Verwenden Sie diese URL.

https://mcp.noimosai.com/mcp

Folgen Sie der Anleitung Ihres Clients.

In Claude Code fügen Sie den Endpunkt so hinzu.

claude mcp add --scope local --transport http noimosai https://mcp.noimosai.com/mcp

Führen Sie /mcp in einer Sitzung aus, autorisieren Sie im Browser und kehren Sie zurück.

In Claude.ai oder Claude Desktop registrieren Sie einen benutzerdefinierten Konnektor.Öffnen Sie Settings → Connectors → Add custom connector, tragen Sie https://mcp.noimosai.com/mcp ein und speichern Sie. Melden Sie sich im Browser an und autorisieren Sie.

In ChatGPT Desktop registrieren Sie einen MCP-Server.

Öffnen Sie Settings → MCP servers, dann Add server.
Setzen Sie Name NoimosAI, Transport Streamable HTTP und URL https://mcp.noimosai.com/mcp.
Speichern und Restart wählen.
In der Serverliste Authenticate wählen und im Browser autorisieren.

Mit /mcp im Eingabefeld sehen Sie verbundene Server. Laut aktueller OpenAI-Anleitung nutzt ChatGPT Web Remote-Tools installierter Plugins statt lokaler Einstellungen. Die direkte Verbindung hier betrifft Desktop.

In Codex CLI fügen diese Befehle den Endpunkt hinzu und starten OAuth.

codex mcp add noimosai --url https://mcp.noimosai.com/mcp
codex mcp login noimosai

Prüfen Sie die Registrierung mit codex mcp list. ChatGPT Desktop, Codex CLI und IDE-Erweiterung teilen MCP-Einstellungen desselben Codex-Hosts.

In Cursor ergänzen Sie die Projektdatei .cursor/mcp.json.

{
  "mcpServers": {
    "noimosai": {
      "url": "https://mcp.noimosai.com/mcp"
    }
  }
}

Aktivieren Sie NoimosAI in den MCP-Einstellungen und schließen Sie die Browser-Anmeldung ab.

In VS Code ergänzen Sie die Workspace-Datei .vscode/mcp.json.

{
  "servers": {
    "noimosai": {
      "type": "http",
      "url": "https://mcp.noimosai.com/mcp"
    }
  }
}

Beim Serverstart beginnt VS Code die Browser-OAuth-Anmeldung.

Prüfen Sie Konto und mcp:tools im Zustimmungsdialog. Verbinden Sie danach neu und prüfen Sie die Toolliste.

Mit Local verbinden

Local startet das npm-Paket @noimosai/mcp als Kindprozess des Clients. Bereiten Sie drei Dinge vor:

Node.js 20 oder neuer
MCP-Client mit STDIO
API-Schlüssel aus dem API-Tab der NoimosAI-Teameinstellungen

Ersetzen Sie your-api-key durch Ihren Schlüssel. Ergänzen Sie NOIMOS_WORKSPACE_ID nur für einen festen Standard-Workspace.

Konfigurationen mit Schlüsseln niemals teilen oder committen. Hier gelten reguläre NoimosAI-Schlüssel; Developer-Platform-Schlüssel nmp_ sind nicht nutzbar.

Claude Code
Claude Desktop
Codex
Cursor
VS Code

In Claude Code fügen Sie den lokalen Server so hinzu.

claude mcp add noimosai \
  --env NOIMOS_API_KEY=your-api-key \
  --env MCP_TOOL_TIMEOUT=900000 \
  -- npx -y @noimosai/mcp

In Claude Desktop ergänzen Sie claude_desktop_config.json.

{
  "mcpServers": {
    "noimosai": {
      "command": "npx",
      "args": ["-y", "@noimosai/mcp"],
      "env": {
        "NOIMOS_API_KEY": "your-api-key"
      }
    }
  }
}

In Codex CLI fügen Sie den lokalen Server so hinzu.

codex mcp add noimosai \
  --env NOIMOS_API_KEY=your-api-key \
  --env NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS="$PWD" \
  -- npx -y @noimosai/mcp

Dies erlaubt Uploads und Downloads nur im Ordner der Befehlsausführung.

In Cursor ergänzen Sie .cursor/mcp.json.

{
  "mcpServers": {
    "noimosai": {
      "command": "npx",
      "args": ["-y", "@noimosai/mcp"],
      "env": {
        "NOIMOS_API_KEY": "your-api-key"
      }
    }
  }
}

In VS Code ergänzen Sie .vscode/mcp.json.

{
  "servers": {
    "noimosai": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@noimosai/mcp"],
      "env": {
        "NOIMOS_API_KEY": "your-api-key"
      }
    }
  }
}

Local unterstützt diese Umgebungsvariablen:

Variable	Pflicht	Beschreibung
`NOIMOS_API_KEY`	Ja	Schlüssel aus dem API-Tab der Teameinstellungen.
`NOIMOS_WORKSPACE_ID`	Nein	Standard-Workspace bei fehlendem `workspaceId` im Toolaufruf.
`NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS`	Nein	Erlaubte lokale Uploadordner; mehrere mit dem OS-Pfadtrennzeichen trennen.

Erlauben Sie nur benötigte Ordner. Für den aktuellen Ordner tragen Sie dessen absoluten Pfad als NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS in die Startkonfiguration ein. Starten Sie den Client neu und prüfen Sie Tools. chat und create_workspace_and_onboard können Minuten dauern; setzen Sie nach Möglichkeit etwa 15 Minuten Timeout.

Erste Tools ausprobieren

Beginnen Sie mit Lesezugriffen, um Workspace und Daten sicher zu prüfen. Bitten Sie den Client der Reihe nach:

„Liste meine verfügbaren NoimosAI-Workspaces auf.“
„Prüfe Markenübersicht und verbundene Konten des Ziel-Workspaces.“
„Erstelle damit einen LinkedIn-Entwurf. Zeige nur den Text, veröffentliche nichts.“

Die ersten beiden nutzen Lesetools wie list_workspaces und get_workspace_context. Auch der dritte Auftrag enthält keine Veröffentlichung; prüfen Sie das Ergebnis vor weiteren Schritten.

Verbindungsfehler beheben

Prüfen Sie passend zur Verbindungsart:

Remote-Zustimmung öffnet nicht — Verbindung entfernen und neu hinzufügen.
Remote-Tools fehlen — mcp:tools und vorhandenen Workspace prüfen.
Remote-Token abgelaufen — Im Client erneut autorisieren.
Local startet nicht — Node.js 20+, npx, Paketnamen und Schlüssel prüfen.
Local-Workspace nicht wählbar — NOIMOS_WORKSPACE_ID oder workspaceId im Aufruf prüfen.
Local-Datei nicht lesbar — Erlaubten Ordner unter NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS prüfen.

Weiterführende Seiten

Toolauswahl und andere Zugriffe erläutern diese Seiten.

​Überblick

​Verbindung wählen

​Mit Remote verbinden

​Mit Local verbinden

​Erste Tools ausprobieren

​Verbindungsfehler beheben

​Weiterführende Seiten

Überblick

Verbindung wählen

Mit Remote verbinden

Mit Local verbinden

Erste Tools ausprobieren

Verbindungsfehler beheben

Weiterführende Seiten