@bitpalm/os-mcp

MCP Server for BitPalm OS — manage projects, tasks, and feedback directly from Claude Code.

Setup (2 Minuten, einmalig)

1. Install

npm install -g @bitpalm/os-mcp

2. API Secret setzen

Den Secret bekommst du von deinem Team Lead.

echo 'export BITPALM_API_SECRET="HIER_SECRET_EINFÜGEN"' >> ~/.zshrc
source ~/.zshrc

3. In deinem AI Code Editor konfigurieren

Claude Code

mkdir -p ~/.claude

Erstelle oder erweitere ~/.claude/settings.json:

{
  "mcpServers": {
    "bitpalm-os": {
      "command": "bitpalm-mcp",
      "env": {
        "BITPALM_API_SECRET": "${BITPALM_API_SECRET}"
      }
    }
  }
}

Codex (OpenAI)

codex mcp add bitpalm-os -- bitpalm-mcp

Oder manuell in ~/.codex/config.toml:

[mcp_servers.bitpalm-os]
command = "bitpalm-mcp"

[mcp_servers.bitpalm-os.env]
BITPALM_API_SECRET = "${BITPALM_API_SECRET}"

4. Editor neustarten

Fertig. Die Tools sind jetzt verfügbar.

Available Tools

| Tool | Description | |---|---| | list_projects | Alle Projekte anzeigen | | get_project | Projekt-Details + alle Tasks | | find_project_by_repo | Projekt automatisch anhand der Git Remote URL finden | | create_task | Einen Task erstellen | | create_tasks_batch | Mehrere Tasks auf einmal erstellen | | update_task | Task-Status oder Priorität ändern | | add_feedback | Schnelles Feedback oder Bug melden | | get_open_feedback | Offenes/unerledigtes Feedback anzeigen | | resolve_feedback | Feedback als erledigt markieren | | update_project_description | Projektbeschreibung aktualisieren (z.B. nach Code-Analyse) | | get_project_status | Status-Zusammenfassung für Kunden generieren | | get_claude_md | CLAUDE.md für ein Repo generieren |

Usage Examples

In Claude Code einfach natürlich fragen:

• "Zeig mir alle Projekte"
• "Erstelle einen Task im Projekt X: Login Button fixen"
• "Analysiere den Code und erstelle Tasks für alles was noch gemacht werden muss"
• "Feedback: Die API gibt 500 zurück auf /users"
• "Generiere ein Status-Update für den Kunden"
• "Erstelle eine CLAUDE.md für dieses Projekt"
• "Finde heraus zu welchem Projekt dieses Repo gehört"
• "Analysiere den Code und aktualisiere die Projektbeschreibung in BitPalm OS"
• "Was für Feedback gibt es das ich umsetzen muss?"
• "Feedback abc ist erledigt"

Projekt-Kontext

Damit Claude Code weiß welches Projekt zu einem Repo gehört, schreibe die Projekt-ID in die CLAUDE.md des Repos:

BitPalm OS Projekt-ID: 4a8b9c2d-1234-5678-...

Die Projekt-ID findest du in der URL wenn du das Projekt in BitPalm OS öffnest.

License

MIT