NoimosAI MCP-Server

Überblick

Der NoimosAI MCP-Server stellt Ihren NoimosAI-Arbeitsbereich über das Model Context Protocol 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.

Remote (empfohlen)
Local (npm)

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

Claude Code
Claude.ai / Desktop
ChatGPT Web

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.

Settings → Connectors → Add custom connector → URL auf https://mcp.noimosai.com/mcp setzen → im Browser anmelden und zustimmen.

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.

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.

Veröffentlicht auf npm als @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.

Claude Desktop
Cursor
VS Code

In claude_desktop_config.json eintragen:

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

In .cursor/mcp.json eintragen:

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

In .vscode/mcp.json eintragen:

{
  "servers": {
    "noimosai": {
      "command": "npx",
      "args": ["-y", "@agos-labs/noimosai-mcp"],
      "env": {
        "NOIMOS_API_KEY": "your-api-key",
        "NOIMOS_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

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.

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

Entwickler

NoimosAI MCP-Server

Überblick

Voraussetzungen

Autorisierung

Einrichtung

Hinweise

Fehlersuche

Voraussetzungen

Konfiguration

Umgebungsvariablen

Tools

`chat`

`list_workspaces`

`list_integrations`

`post`

Verwandt

Entwickler

Documentation Index

​Überblick

​Voraussetzungen

​Autorisierung

​Einrichtung

​Hinweise

​Fehlersuche

​Voraussetzungen

​Konfiguration

​Umgebungsvariablen

​Tools

​chat

​list_workspaces

​list_integrations

​post

​Verwandt

Überblick

Voraussetzungen

Autorisierung

Einrichtung

Hinweise

Fehlersuche

Voraussetzungen

Konfiguration

Umgebungsvariablen

Tools

`chat`

`list_workspaces`

`list_integrations`

`post`

Verwandt