> ## 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.

# NoimosAI MCP-Server

> Nutzen Sie NoimosAI von Claude, ChatGPT, Cursor und anderen MCP-kompatiblen Clients aus.

## Überblick

Der NoimosAI MCP-Server stellt Ihren NoimosAI-Arbeitsbereich über das [Model Context Protocol](https://modelcontextprotocol.io) bereit. Sobald er verbunden ist, können MCP-kompatible Clients mit dem NoimosAI-Agenten chatten, Arbeitsbereiche und Integrationen auflisten und Social-Media-Posts direkt aus dem Client veröffentlichen.

Zwei Verbindungsarten:

* **Remote MCP (empfohlen)** — Gehostet unter `https://mcp.noimosai.com/mcp`. Browser-OAuth, keine Installation, läuft als Sie.
* **Local MCP (`@agos-labs/noimosai-mcp`)** — Server lokal via npm ausführen. Geeignet für Headless- / API-Schlüssel-Setups.

<Tabs>
  <Tab title="Remote (empfohlen)">
    Endpoint: `https://mcp.noimosai.com/mcp`

    ### Voraussetzungen

    * Ein NoimosAI-Konto (angemeldet)
    * Ein Client, der Remote MCP / Custom Connectors unterstützt

    ### Autorisierung

    Der Client registriert sich selbst, dann öffnet ein Browser die NoimosAI-Anmeldung samt Zustimmung zum Scope `mcp:tools`. Nach der Zustimmung wird ein Access-Token ausgestellt und Tool-Aufrufe laufen als Sie.

    ### Einrichtung

    <Tabs>
      <Tab title="Claude Code">
        ```bash theme={null}
        claude mcp add --scope local --transport http noimos https://mcp.noimosai.com/mcp
        ```

        In einer Sitzung `/mcp` ausführen, im Browser zustimmen und zu Claude Code zurückkehren.
      </Tab>

      <Tab title="Claude.ai / Desktop">
        Settings → Connectors → **Add custom connector** → URL auf `https://mcp.noimosai.com/mcp` setzen → im Browser anmelden und zustimmen.
      </Tab>

      <Tab title="ChatGPT Web">
        Custom MCP Connector mit URL `https://mcp.noimosai.com/mcp` hinzufügen und zustimmen. ChatGPT erkennt keine generischen `search` / `fetch`-Tools — NoimosAI-Tools namentlich aufrufen.
      </Tab>
    </Tabs>

    ### Hinweise

    * `post` immer zuerst mit `dryRun: true` aufrufen, um den Payload zu prüfen. Ohne `dryRun` werden Posts auf dem echten Social-Konto veröffentlicht.
    * Zum Trennen den Connector im Client entfernen.

    ### Fehlersuche

    * **Browser öffnet keine Zustimmung** — Connector entfernen und neu hinzufügen.
    * **Keine Tools sichtbar** — Scope `mcp:tools` und mindestens einen Arbeitsbereich am Konto prüfen.
    * **Token abgelaufen** — im Client erneut autorisieren.
  </Tab>

  <Tab title="Local (npm)">
    Veröffentlicht auf npm als [`@agos-labs/noimosai-mcp`](https://www.npmjs.com/package/@agos-labs/noimosai-mcp). Läuft als Kindprozess des Clients.

    ### Voraussetzungen

    * Node.js `>= 18`
    * Ein MCP-kompatibler Client (Claude Desktop, Cursor, VS Code, …)
    * Ein NoimosAI-API-Schlüssel aus den Team-Einstellungen

    ### Konfiguration

    Ersetzen Sie `your-api-key` und `your-workspace-id` durch die Werte aus Ihren NoimosAI-Team-Einstellungen.

    <Tabs>
      <Tab title="Claude Desktop">
        In `claude_desktop_config.json` eintragen:

        ```json theme={null}
        {
          "mcpServers": {
            "noimosai": {
              "command": "npx",
              "args": ["-y", "@agos-labs/noimosai-mcp"],
              "env": {
                "NOIMOS_API_KEY": "your-api-key",
                "NOIMOS_WORKSPACE_ID": "your-workspace-id"
              }
            }
          }
        }
        ```
      </Tab>

      <Tab title="Cursor">
        In `.cursor/mcp.json` eintragen:

        ```json theme={null}
        {
          "mcpServers": {
            "noimosai": {
              "command": "npx",
              "args": ["-y", "@agos-labs/noimosai-mcp"],
              "env": {
                "NOIMOS_API_KEY": "your-api-key",
                "NOIMOS_WORKSPACE_ID": "your-workspace-id"
              }
            }
          }
        }
        ```
      </Tab>

      <Tab title="VS Code">
        In `.vscode/mcp.json` eintragen:

        ```json theme={null}
        {
          "servers": {
            "noimosai": {
              "command": "npx",
              "args": ["-y", "@agos-labs/noimosai-mcp"],
              "env": {
                "NOIMOS_API_KEY": "your-api-key",
                "NOIMOS_WORKSPACE_ID": "your-workspace-id"
              }
            }
          }
        }
        ```
      </Tab>
    </Tabs>

    Starten Sie den Client nach der Konfigurationsänderung neu, damit der MCP-Server geladen wird.

    ### Umgebungsvariablen

    | Variable              | Erforderlich | Beschreibung                                                              |
    | --------------------- | ------------ | ------------------------------------------------------------------------- |
    | `NOIMOS_API_KEY`      | Ja           | NoimosAI-API-Schlüssel (im API-Tab Ihrer Team-Einstellungen verfügbar).   |
    | `NOIMOS_WORKSPACE_ID` | Nein         | Standard-Arbeitsbereichs-ID, wenn ein Tool-Aufruf `workspaceId` weglässt. |
  </Tab>
</Tabs>

## Tools

Beide Transporte stellen dieselben Tools bereit.

### `chat`

Sendet eine Nachricht an den NoimosAI-Agenten. Liefert strukturiertes NoimosPostJson mit der Antwort des Agenten und allen extrahierten Social-Posts. Geeignet für Marketinganalyse, Erstellung von Social-Posts, SEO und Content-Generierung.

| Parameter     | Typ      | Erforderlich | Beschreibung                                                                                        |
| ------------- | -------- | ------------ | --------------------------------------------------------------------------------------------------- |
| `prompt`      | `string` | Ja           | Nachricht oder Anweisung an den Agenten.                                                            |
| `workspaceId` | `string` | Nein         | Arbeitsbereichs-ID. Fallback: `NOIMOS_WORKSPACE_ID` (Local) oder Standard des autorisierten Kontos. |
| `sessionId`   | `string` | Nein         | Sitzungs-ID zum Fortsetzen einer Unterhaltung. Ohne Angabe wird eine neue Sitzung erstellt.         |

### `list_workspaces`

Listet verfügbare Arbeitsbereiche mit ID und Name. Keine Parameter.

### `list_integrations`

Listet verbundene Integrationen (Social-Media-Konten) des Arbeitsbereichs. Liefert Konto-IDs (`providerAccountId`), die das `post`-Tool je Eintrag benötigt.

### `post`

Veröffentlicht Social-Media-Posts. Akzeptiert Postdaten im NoimosPostJson-Format aus `chat`. Jeder Eintrag muss `providerAccountId` enthalten (über `list_integrations` abrufbar). Beginnen Sie immer mit `dryRun: true`, um den Payload zu prüfen.

| Parameter     | Typ       | Erforderlich | Beschreibung                                                                          |
| ------------- | --------- | ------------ | ------------------------------------------------------------------------------------- |
| `posts`       | `array`   | Ja           | Array mit Posts im NoimosPostJson-Format. Jeder Eintrag benötigt `providerAccountId`. |
| `schedule`    | `string`  | Ja           | Zeitpunkt der Veröffentlichung. `"now"` für sofort, `"YYYY-MM-DD HH:MM"` für geplant. |
| `workspaceId` | `string`  | Nein         | Arbeitsbereichs-ID. Fallback: Standard-Arbeitsbereich.                                |
| `dryRun`      | `boolean` | Nein         | Bei `true` wird nur angezeigt, was gesendet würde. Standard: `false`.                 |

## Verwandt

* [Was ist NoimosAI?](/de/help-center/getting-started/what-is-noimosai)
* [NoimosAI CLI](/de/developers/cli/overview)
* [npm-Paket](https://www.npmjs.com/package/@agos-labs/noimosai-mcp)