Work Integrations MCP

Dies ist ein kleiner MCP-Server, der Tools für mehrere Arbeitssysteme bereitstellt (derzeit Jira, mit geplantem Support für Slack/GitHub und andere).

Aktuelle Tools

• jira_get_issue - Einen Jira-Vorgang anhand des Schlüssels abrufen

• jira_search - Jira mittels JQL durchsuchen

• slack_get_message_by_url - Eine Slack-Nachricht per URL abrufen

• slack_get_channel_history - Aktuelle Slack-Nachrichten abrufen

• slack_find_channel - Kanalnamen in ID auflösen

• slack_find_user - Benutzer per E-Mail oder Anzeigename auflösen

• confluence_get_page - Eine Confluence-Seite per ID abrufen (inklusive Fußzeile + Inline-Kommentare mit verschachtelten Antworten)

• confluence_get_page_by_url - Eine Confluence-Seite per URL abrufen (inklusive Fußzeile + Inline-Kommentare mit verschachtelten Antworten)

• confluence_search - Confluence mittels CQL durchsuchen

Einrichtung

1. Abhängigkeiten installieren:

   • npm install

2. Umgebungsvariablen konfigurieren (Beispiele):

   • JIRA_BASE=https://company.atlassian.net

   • JIRA_EMAIL=you@company.com

   • JIRA_TOKEN=your_api_token

   • JIRA_API_VERSION=3

   • SLACK_TOKEN=xoxb-your-slack-bot-token

   • CONFLUENCE_BASE=https://company.atlassian.net/wiki

   • CONFLUENCE_EMAIL=you@company.com

   • CONFLUENCE_TOKEN=your_api_token

3. Den MCP-Server in Cursor registrieren (~/.cursor/mcp.json):

   {
     "mcpServers": {
       "work-integrations-mcp": {
         "command": "npx",
         "args": [
           "tsx",
           "/ABS/PATH/jira-mcp/server.ts"
         ],
         "env": {
           "JIRA_BASE": "https://company.atlassian.net",
           "JIRA_EMAIL": "you@company.com",
           "JIRA_TOKEN": "your_api_token",
           "JIRA_API_VERSION": "3",
          "SLACK_TOKEN": "xoxb-your-slack-bot-token",
          "CONFLUENCE_BASE": "https://company.atlassian.net/wiki",
          "CONFLUENCE_EMAIL": "you@company.com",
          "CONFLUENCE_TOKEN": "your_api_token"
         }
       }
     }
   }

4. Cursor neu starten.

Anwendungsbeispiele

• "Verwende jira_get_issue mit dem Schlüssel CVR-248"

• "Suche in Jira mit JQL: project = CVR ORDER BY updated DESC"

• "Verwende slack_get_message_by_url mit der URL https://..."

• "Verwende slack_get_channel_history mit dem Kanal general"

• "Verwende slack_find_user mit der E-Mail user@company.com"

• "Verwende confluence_get_page mit der ID 123456"

• "Verwende confluence_get_page_by_url mit der URL https://.../wiki/..."

• "Verwende confluence_search mit CQL space = DOCS and type = page"

Hinweise zur Slack-Einrichtung

Erstelle eine Slack-App und installiere sie in deinem Workspace. Erforderliche Mindestberechtigungen für öffentliche Kanäle:

• channels:read

• channels:history

• users:read

• users:read.email

Für private Kanäle füge hinzu:

• groups:read

• groups:history

Erweiterung

Füge neue Tools für Slack, GitHub oder andere Dienste hinzu, indem du einen neuen Ordner unter services/ erstellst und das Modul in server.ts registrierst:

1. Erstelle services/<service>/client.ts für Authentifizierung + API-Aufrufe

2. Erstelle services/<service>/tools.ts, das ein ToolModule exportiert

3. Importiere das Modul in server.ts und übergebe es an mergeToolModules

4. Füge bei Bedarf neue Umgebungsvariablen in der Cursor-MCP-Konfiguration hinzu

Halte die Tool-Namen stabil, damit bestehende Prompts weiterhin funktionieren.