@orbitlogistics/mcp-plain

MCP-Server für die Plain Kundensupport-Plattform. Stellt Tools zur Verwaltung von Threads, Help-Center-Artikeln und mehr über das Model Context Protocol bereit.

Einrichtung

Mit Claude Code

Fügen Sie zu .claude/settings.json Ihres Projekts hinzu:

{
  "mcpServers": {
    "plain": {
      "command": "npx",
      "args": ["-y", "@orbitlogistics/mcp-plain@latest"],
      "env": {
        "PLAIN_API_KEY": "${PLAIN_API_KEY}"
      }
    }
  }
}

Setzen Sie dann PLAIN_API_KEY in Ihrer Shell-Umgebung (z. B. .zshrc, .envrc oder einem Secrets-Manager).

Mit anderen MCP-Clients

Führen Sie den Server direkt aus:

PLAIN_API_KEY=plainApiKey_xxx npx @orbitlogistics/mcp-plain@latest

Related MCP server: plane-mcp-server

Tools

Hinweis: Dieser Server deckt nicht die vollständige Plain-API ab – nur die Endpunkte, die wir aktiv nutzen. Wenn Sie zusätzliche Methoden benötigen, sind PRs willkommen!

Threads

• list_threads – Threads mit Filtern auflisten (Status, Priorität, Labels, Kunde, Mandant)

• get_thread – Vollständige Thread-Details nach ID abrufen (inklusive Timeline)

• get_thread_by_ref – Thread nach Referenznummer abrufen (z. B. T-510)

• get_thread_fields – Benutzerdefinierte Feldwerte für einen Thread abrufen

• create_thread – Neuen Thread erstellen (erstellt Kunden automatisch per E-Mail, falls erforderlich)

• reply_to_thread – Antwort über den ursprünglichen Kanal senden

• mark_thread_as_done – Thread als erledigt markieren

• upsert_thread_field – Benutzerdefinierte Feldwerte festlegen/aktualisieren

• add_internal_note – Interne Notiz posten (für Kunden nicht sichtbar)

• add_labels – Kategorie-Labels zu einem Thread hinzufügen

• get_label_types – Verfügbare Label-Typen auflisten

Thread-Links

• link_threads – Thread mit einem anderen Plain-Thread, einem Linear-Issue, einem Jira-Issue oder einer generischen Quelle verknüpfen

• get_thread_links – Links eines Threads auflisten

• unlink_thread – Link anhand seiner Link-ID entfernen

get_thread und get_thread_by_ref geben außerdem die ersten 25 Links eines Threads in einem links-Array zurück.

Anhänge

• get_attachment_download_url – Temporäre Download-URL abrufen

• get_attachment_content – Anhangsinhalt abrufen (Text oder base64)

Help Center

• list_help_centers – Alle Help Center auflisten

• get_help_center – Help-Center-Struktur abrufen (Gruppen und Artikel)

• list_help_center_articles – Artikel mit vollständigem Inhalt auflisten

• get_help_center_article – Artikel nach ID abrufen

• get_help_center_article_by_slug – Artikel nach URL-Slug abrufen

• upsert_help_center_article – Artikel erstellen oder aktualisieren (wird immer als ENTWURF gespeichert)

• create_help_center_article_group – Artikelgruppe erstellen

• delete_help_center_article_group – Leere Artikelgruppe löschen

Entwicklung

pnpm install
pnpm test
pnpm build

Lizenz

MIT