> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noimosai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Clients verbinden

> Remote oder Local MCP mit einem unterstützten KI-Client 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 |

> [!NOTE]
>
> 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.

```text theme={null}
https://mcp.noimosai.com/mcp
```

Folgen Sie der Anleitung Ihres Clients.

> [tab] Claude Code
>
> In Claude Code fügen Sie den Endpunkt so hinzu.
>
> ```bash theme={null}
> 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.

> [tab] Claude.ai / Desktop
>
> 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.

> [tab] ChatGPT Desktop
>
> In ChatGPT Desktop registrieren Sie einen MCP-Server.
>
> 1. Öffnen Sie **Settings → MCP servers**, dann **Add server**.
> 2. Setzen Sie Name `NoimosAI`, Transport **Streamable HTTP** und URL `https://mcp.noimosai.com/mcp`.
> 3. Speichern und **Restart** wählen.
> 4. In der Serverliste **Authenticate** wählen und im Browser autorisieren.
>
> Mit `/mcp` im Eingabefeld sehen Sie verbundene Server. Laut [aktueller OpenAI-Anleitung](https://learn.chatgpt.com/docs/extend/mcp) nutzt ChatGPT Web Remote-Tools installierter Plugins statt lokaler Einstellungen. Die direkte Verbindung hier betrifft Desktop.

> [tab] Codex
>
> In Codex CLI fügen diese Befehle den Endpunkt hinzu und starten OAuth.
>
> ```bash theme={null}
> 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.

> [tab] Cursor
>
> In Cursor ergänzen Sie die Projektdatei `.cursor/mcp.json`.
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "noimosai": {
>       "url": "https://mcp.noimosai.com/mcp"
>     }
>   }
> }
> ```
>
> Aktivieren Sie NoimosAI in den MCP-Einstellungen und schließen Sie die Browser-Anmeldung ab.

> [tab] VS Code
>
> In VS Code ergänzen Sie die Workspace-Datei `.vscode/mcp.json`.
>
> ```json theme={null}
> {
>   "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`](https://www.npmjs.com/package/@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.

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

> [tab] Claude Code
>
> In Claude Code fügen Sie den lokalen Server so hinzu.
>
> ```bash theme={null}
> claude mcp add noimosai \
>   --env NOIMOS_API_KEY=your-api-key \
>   --env MCP_TOOL_TIMEOUT=900000 \
>   -- npx -y @noimosai/mcp
> ```

> [tab] Claude Desktop
>
> In Claude Desktop ergänzen Sie `claude_desktop_config.json`.
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "noimosai": {
>       "command": "npx",
>       "args": ["-y", "@noimosai/mcp"],
>       "env": {
>         "NOIMOS_API_KEY": "your-api-key"
>       }
>     }
>   }
> }
> ```

> [tab] Codex
>
> In Codex CLI fügen Sie den lokalen Server so hinzu.
>
> ```bash theme={null}
> 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.

> [tab] Cursor
>
> In Cursor ergänzen Sie `.cursor/mcp.json`.
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "noimosai": {
>       "command": "npx",
>       "args": ["-y", "@noimosai/mcp"],
>       "env": {
>         "NOIMOS_API_KEY": "your-api-key"
>       }
>     }
>   }
> }
> ```

> [tab] VS Code
>
> In VS Code ergänzen Sie `.vscode/mcp.json`.
>
> ```json theme={null}
> {
>   "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:

1. „Liste meine verfügbaren NoimosAI-Workspaces auf.“
2. „Prüfe Markenübersicht und verbundene Konten des Ziel-Workspaces.“
3. „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.

* [Tools nutzen](https://docs.noimosai.com/de/developers/mcp/tools.md)
* [Grundlagen verstehen](https://docs.noimosai.com/de/developers/cli/overview.md)
* [Standardanleitung für MCP-Verbindungen](https://modelcontextprotocol.io/docs/develop/connect-local-servers)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.