dooray-mcp-js

Dooray-MCP-Server, implementiert in Node.js. Er folgt den Tool-Namen und dem API-Verhalten von dooray-go/dooray-mcp, benötigt aber weder Go noch Homebrew.

Voraussetzungen

• Node.js 18 oder neuer

• Persönliches Dooray-API-Token

Related MCP server: mcp-gdocs

Offizielle Dokumentation

• Offizielle Dooray-API-Dokumentation

Umfang

Dieser MCP-Server kapselt nicht jede Dooray-API. Er konzentriert sich auf häufig verwendete APIs für Konto, Kalender, Projekt, Beitrag, Anhang und Messenger.

Die meisten Verwaltungs-APIs /admin/v1 und /admin/v2 sind standardmäßig absichtlich nicht verfügbar, insbesondere schreibfähige Verwaltungs-Endpunkte.

Nur-Lese-Modus

Persönliche Dooray-API-Tokens werden nicht mit getrennten Lese- und Schreibberechtigungen ausgestellt. Ein Token, das Schreib-APIs aufrufen kann, kann diese Berechtigungen auf Dooray-API-Ebene weiterhin besitzen.

Für sicherere Installationen bietet dieser Server einen Nur-Lese-Modus auf der MCP-Tool-Ebene. Im Nur-Lese-Modus werden schreibfähige Tools nicht in tools/list angezeigt und können nicht über tools/call aufgerufen werden.

Ausführen

npx -y dooray-mcp-js --token "{personal-token}"

Sie können auch eine Umgebungsvariable verwenden:

DOORAY_TOKEN="{personal-token}" npx -y dooray-mcp-js

Ausführen mit nur verfügbaren Nur-Lese-Tools:

DOORAY_TOKEN="{personal-token}" npx -y dooray-mcp-js --mode read-only

Codex

Registrieren Sie das Paket direkt mit Codex:

codex mcp add dooray-mcp-js --env DOORAY_TOKEN="$DOORAY_TOKEN" -- npx -y dooray-mcp-js

Wenn das Token nicht bereits in DOORAY_TOKEN vorhanden ist, übergeben Sie es bei der Registrierung:

codex mcp add dooray-mcp-js --env DOORAY_TOKEN="{personal-token}" -- npx -y dooray-mcp-js

Der Server liest DOORAY_TOKEN, wenn Codex ihn startet, sodass das Token nicht in den Befehlsargumenten enthalten sein muss.

Codex-Registrierung im Nur-Lese-Modus

Registrieren Sie einen zweiten MCP-Server mit demselben Paket und Token, aber legen Sie nur Nur-Lese-Tools offen:

codex mcp add dooray-mcp-js-read-only --env DOORAY_TOKEN="$DOORAY_TOKEN" -- npx -y dooray-mcp-js --mode read-only

Sie können den Modus auch über eine Umgebungsvariable festlegen:

codex mcp add dooray-mcp-js-read-only --env DOORAY_TOKEN="$DOORAY_TOKEN" --env DOORAY_MCP_MODE=read-only -- npx -y dooray-mcp-js

Claude Desktop

{
  "mcpServers": {
    "dooray-mcp-js": {
      "command": "npx",
      "args": ["-y", "dooray-mcp-js"],
      "env": {
        "DOORAY_TOKEN": "{personal-token}"
      }
    }
  }
}

Nur-Lese-Konfiguration für Claude Desktop:

{
  "mcpServers": {
    "dooray-mcp-js-read-only": {
      "command": "npx",
      "args": ["-y", "dooray-mcp-js", "--mode", "read-only"],
      "env": {
        "DOORAY_TOKEN": "{personal-token}"
      }
    }
  }
}

Claude Code

claude mcp add dooray-mcp-js --env DOORAY_TOKEN="{personal-token}" -- npx -y dooray-mcp-js

Registrierung im Nur-Lese-Modus:

claude mcp add dooray-mcp-js-read-only --env DOORAY_TOKEN="{personal-token}" -- npx -y dooray-mcp-js --mode read-only

Projektstruktur

dooray-mcp-js/
├── src/
│   └── index.js      # MCP server entry point
├── package.json
└── README.md

Lokale Entwicklung

Wenn Sie aus einem geklonten Repository arbeiten, führen Sie den lokalen Einstiegspunkt direkt aus:

DOORAY_TOKEN="{personal-token}" node ./src/index.js

Tools

Das Paket dooray-mcp-js stellt alle derzeit implementierten Tools bereit. Der aktuelle Server hat noch kein Lösch-Tool.

• dooray_messenger

• dooray_calendar_calendars

• dooray_calendar_events

• dooray_calendar_post_event

• dooray_account_members

• dooray_account_member

• dooray_project

• dooray_posts (findet Aufgabenbeiträge und stellt den Aufgabeninhalt sowie fileIdList bereit, die Inline-Bilder/Dateien enthalten kann)

• dooray_post_logs (findet Kommentare und Aktivitätsprotokolle für einen Beitrag)

• dooray_post_log (findet einen Kommentar oder ein Aktivitätsprotokoll anhand der ID)

• dooray_post_log_create (fügt einen Kommentar zu einem Beitrag hinzu; der Inhalt ist { "mimeType": "text/x-markdown", "content": "..." })

• dooray_post_log_update (aktualisiert einen Kommentar oder ein Aktivitätsprotokoll mit demselben Inhaltformat)

• dooray_post_files (listet reguläre Anhänge auf; ein leeres Ergebnis oder AUTH_FORBIDDEN_ERROR bestimmt nicht, ob fileIdList-Elemente heruntergeladen werden können)

• dooray_post_file_download (lädt IDs aus dooray_posts.fileIdList herunter, einschließlich Inline-Bildern, oder reguläre Anhang-Datei-IDs mit media=raw; die Autorisierung ist auf den konfigurierten API-Ursprung und HTTPS file-api.dooray.com beschränkt)

• os

Lesen von Aufgaben-URLs und Dateien im Inhalt

Verwenden Sie diesen Arbeitsablauf, wenn eine Anfrage einen Dooray-Aufgabeninhalt, ein in den Inhalt eingebettetes Bild oder eine vom Inhalt referenzierte Datei verlangt. Kommentare und Aktivitätsprotokolle sind eine separate Ressource und für diesen Arbeitsablauf nicht erforderlich.

1. Analysieren Sie die Aufgaben-URL. /task/{projectId}/{postId} liefert beide IDs direkt. Die ältere Form /project/tasks/{postId} liefert nur postId, daher darf ihre nachgestellte Zahl nicht als projectId verwendet werden.

2. Lösen Sie das Projekt nur für die ältere URL-Form auf. Rufen Sie dooray_project mit operation=find_projects und den erforderlichen Filtern type, scope und state auf. Wiederholen Sie die relevanten Filterkombinationen und fahren Sie mit page-Werten und size bis zu 100 fort, bis jede Ergebnisseite geprüft wurde.

3. Suchen Sie nach dem passenden Beitrag. Rufen Sie dooray_posts mit der Projekt-ID aus der neuen URL-Form oder den für eine ältere URL ermittelten Kandidaten-Projekt-IDs auf. Verwenden Sie size bis zu 100, fahren Sie bei Bedarf mit page-Werten fort und gleichen Sie die zurückgegebene Beitrags-ID mit der postId der URL ab. Eine Suche unter einer falschen Projekt-ID oder nur auf der ersten Ergebnisseite ist kein Beweis dafür, dass die Aufgabe oder ihre Dateien nicht verfügbar sind.

4. Lesen Sie den Aufgabeninhalt aus dem passenden dooray_posts-Ergebnis. Rufen Sie dooray_post_logs nicht auf, es sei denn, der Benutzer fragt ausdrücklich nach Kommentaren oder Aktivitätsverlauf.

5. Wenn der passende Beitrag fileIdList enthält, rufen Sie dooray_post_file_download einmal für jede aufgeführte ID mit derselben verifizierten projectId und postId auf. Diese IDs repräsentieren häufig Bilder, die in den Aufgabeninhalt eingebettet sind, können aber auch andere Dateien im Inhalt darstellen.

6. Untersuchen Sie den zurückgegebenen lokalen filePath mit einem Bildbetrachter oder einem geeigneten Dokumentparser. Das Download-Ergebnis enthält auch fileName, mimeType, size und temporary.

dooray_post_files ist zum Auflisten regulärer Anhänge verfügbar, ist jedoch getrennt vom fileIdList-Pfad für Dateien im Inhalt. Es kann eine leere Liste oder AUTH_FORBIDDEN_ERROR zurückgeben, selbst wenn direkte Downloads aus dooray_posts.fileIdList funktionieren. Daher sollte keines der beiden Ergebnisse als Beweis dafür gemeldet werden, dass ein Bild oder eine Datei im Inhalt nicht zugänglich ist. Ein fetch failed-Fehler oder Timeout von dooray_post_file_download ist ebenfalls ein Transportfehler, kein Berechtigungsergebnis, und sollte erneut versucht oder separat gemeldet werden. Melden Sie eine Datei nur dann als verboten oder fehlend, wenn der direkte Download eine endgültige Dooray-Antwort wie 403 oder 404 mit der verifizierten projectId, postId und fileId zurückgibt.

Tools im Nur-Lese-Modus

Wenn --mode read-only oder DOORAY_MCP_MODE=read-only gesetzt ist, werden schreibfähige Dooray-Tools nicht in tools/list angezeigt und können nicht über tools/call aufgerufen werden.

Im Nur-Lese-Modus verfügbar:

• dooray_calendar_calendars

• dooray_calendar_events

• dooray_account_members

• dooray_account_member

• dooray_project

• dooray_posts

• dooray_post_logs

• dooray_post_log

• dooray_post_files

• dooray_post_file_download

• os

Im Nur-Lese-Modus ausgeblendet:

• dooray_messenger

• dooray_calendar_post_event

• dooray_post_log_create

• dooray_post_log_update

Optionen

• --token: Persönliches Dooray-API-Token. Standardmäßig DOORAY_TOKEN.

• --endpoint: Dooray-API-Endpunkt. Standardmäßig https://api.dooray.com.

• --mode: Modus der Tool-Verfügbarkeit. Verwenden Sie full oder read-only. Standardmäßig DOORAY_MCP_MODE oder full.