propyte-mejoras-mcp

Stdio-Brücke für das Board für Mejoras IA von Propyte. Sie lässt Claude Desktop, Claude Code und jeden MCP-Client, der stdio spricht, das Board von hub.propyte.com lesen und schreiben.

Was es ist und was es nicht ist

Dieses Paket implementiert kein Tool. Es übersetzt nur den Transport: Der Client spricht JSON-RPC zeilenweise über stdin, die Hub-Pforte spricht es per POST.

Claude Desktop / Claude Code
        │  stdio (JSON-RPC por líneas)
        ▼
  propyte-mejoras-mcp          ← este paquete: 250 líneas, cero dependencias
        │  HTTPS POST + Authorization: Bearer
        ▼
  hub.propyte.com/api/mcp/mejoras
        │
        ▼
  el tablero (ai_tasks)

Die Tools, ihre Validierung und ihr erneutes Lesen nach dem Schreiben leben im Hub. Zwei praktische Konsequenzen:

• Wenn der Hub neue Tools veröffentlicht, erscheinen sie von selbst in deinem Client. Dieses Paket muss nicht aktualisiert werden.

• Es gibt keine zweite Kopie der Board-Regeln, die mit der des Hubs desynchronisiert werden könnte.

Wenn du Claude Cowork oder claude.ai verwendest, brauchst du das nicht: Dort wird die URL direkt als benutzerdefinierter Connector hinzugefügt. Diese Brücke existiert für Clients, die nur stdio sprechen.

Related MCP server: mcp-streaming-http-proxy

Installation

Erfordert Node 20 oder höher. Es muss nichts kompiliert und keine Abhängigkeiten installiert werden.

1. Besorge dir das Token

Es wird von hub.propyte.com/mejoras/conectar kopiert (man muss ADMIN oder DIRECTOR sein). Dieser Bildschirm zeigt auch das Datum der letzten Rotation.

Frag das Token nicht im Chat ab und kopiere es nicht aus einem Dokument: Der Bildschirm ist die einzige Quelle, die weiß, ob das Geheimnis noch gültig ist.

2. Konfiguriere deinen Client

Claude Desktop — claude_desktop_config.json:

{
  "mcpServers": {
    "propyte-mejoras": {
      "command": "npx",
      "args": ["-y", "github:Propyte-Luis/propyte-mejoras-mcp"],
      "env": {
        "MCP_MEJORAS_TOKEN": "el-token-de-/mejoras/conectar"
      }
    }
  }
}

Claude Code — eine Zeile:

claude mcp add propyte-mejoras \
  --env MCP_MEJORAS_TOKEN=el-token-de-/mejoras/conectar \
  -- npx -y github:Propyte-Luis/propyte-mejoras-mcp

3. Prüfe, dass es gestartet ist

Starte den Client neu und frag die Liste der Tools ab. Du solltest die des Boards sehen (mejoras_list_tasks, mejoras_get_task, mejoras_create_task, mejoras_update_task).

Wenn du es lieber von Hand ohne Client testen möchtest:

export MCP_MEJORAS_TOKEN=...
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npx -y github:Propyte-Luis/propyte-mejoras-mcp

Konfiguration

MCP_MEJORAS_URL wird nur geändert, um auf einen lokalen Hub zu zeigen (http://localhost:3001/api/mcp/mejoras).

Ohne MCP_MEJORAS_TOKEN startet die Brücke nicht und beendet sich mit Code 1 und der Angabe, welche Variable fehlt. Das ist beabsichtigt: Eine Brücke, die ohne Token startet, würde den Client mit einem Server zurücklassen, der auf alles mit „nicht autorisiert“ antwortet, und das liest sich wie „der Hub ist ausgefallen“ – was dazu führt, an der falschen Stelle zu suchen.

⚠️ MCP_MEJORAS_TOKEN ist nicht MCP_BLOG_TOKEN oder MCP_API_TOKEN. Es sind drei verschiedene Geheimnisse für drei verschiedene Pforten.

Was man mit den Tools machen kann

Zwei Regeln, die der Server auferlegt, nicht diese Brücke:

• resumen_humano muss für jemanden, der den Code nicht sieht, sagen, was sich geändert hat. Eine generische Zusammenfassung wird abgelehnt, zusammen mit Beispielen dafür, was brauchbar ist.

• estado = 'desplegada' erfordert einen Nachweis. Ein grünes Badge ohne Nachweis ist genau das, was das Panel verhindern soll.

Sicherheit

• Das Geheimnis reist per Header, nicht im Pfad. Die Pforte akzeptiert beide Formen – der Pfad existiert, weil Cowork keine Header senden kann – aber der Pfad bleibt in den Zugriffsprotokollen des Servers stehen, und ein lokaler Prozess muss diese Kosten nicht tragen. Es gibt einen Test, der das überprüft.

• Auf stdout erscheinen nur JSON-RPC-Nachrichten. Alles andere geht an stderr; alles andere auf stdout liest der Client als Protokoll und schließt die Verbindung.

• Es ist ein gemeinsames Token, das über /mejoras/conectar rotiert werden kann. Es ist keine Datenbank-Anmeldeinformation, und kein Tool dieser Pforte schreibt in das CRM.

Entwicklung

npm test    # 13 tests, cero dependencias

Die Tests laufen gegen eine simulierte MCP-Pforte auf localhost, und zwei davon testen das Binärprogramm als Prozess – nicht das Modul –, denn ein kaputter Shebang oder ein vergessenes console.log wird von keinem Unit-Test erwischt, und das Symptom beim Client ist „der Server startet nicht“, ohne weitere Informationen.

Was sie überprüfen: dass tools/list vollständig durchgeht, ohne dass die Brücke Tools erfindet oder beschneidet, dass das Token nicht in der URL erscheint, dass eine Benachrichtigung keine Antwort erzeugt, dass eine über zwei stdin-Stücke aufgeteilte Nachricht nicht beschädigt wird, dass eine SSE-Antwort unter Ignorieren der Keepalive-Pings ausgepackt wird, und dass ein 401 oder 500 als Fehler mit seinem Grund beim Client ankommt, statt mit Schweigen.