propyte-mejoras-mcp

Propyte의 Mejoras IA 보드를 위한 stdio 브리지. Claude Desktop, Claude Code, 그리고 stdio를 사용하는 모든 MCP 클라이언트가 hub.propyte.com의 보드를 읽고 쓸 수 있게 해줍니다.

무엇이며 무엇이 아닌가

이 패키지는 어떤 tool도 구현하지 않습니다. 단지 전송을 변환할 뿐입니다. 클라이언트는 stdin에서 줄 단위로 JSON-RPC를 말하고, Hub의 게이트는 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)

tools와 그 검증, 그리고 작성 후 다시 읽는 것은 Hub에 있습니다. 두 가지 실용적인 결과가 있습니다.

• Hub가 새 tools를 게시하면 자동으로 클라이언트에 나타납니다. 이 패키지를 업데이트할 필요가 없습니다.

• Hub의 규칙과 동기화가 어긋날 수 있는 두 번째 사본이 없습니다.

Claude Cowork나 claude.ai를 사용한다면 이게 필요 없습니다. 거기서는 URL을 맞춤 커넥터로 직접 추가합니다. 이 브리지는 stdio만 사용하는 클라이언트를 위해 존재합니다.

Related MCP server: mcp-streaming-http-proxy

설치

Node 20 이상이 필요합니다. 컴파일할 것도, 의존성을 설치할 것도 없습니다.

1. 토큰 받기

**hub.propyte.com/mejoras/conectar**에서 복사합니다 (ADMIN 또는 DIRECTOR여야 합니다). 그 화면에는 마지막 회전 날짜도 표시됩니다.

토큰을 채팅으로 요청하거나 문서에서 복사하지 마세요. 화면은 비밀값이 여전히 유효한지 아는 유일한 출처입니다.

2. 클라이언트 설정

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 — 한 줄:

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

3. 시작 확인

클라이언트를 재시작하고 tools 목록을 요청하세요. 보드의 tools(mejoras_list_tasks, mejoras_get_task, mejoras_create_task, mejoras_update_task)가 보여야 합니다.

손으로, 클라이언트 없이 테스트해보고 싶다면:

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

설정

MCP_MEJORAS_URL은 로컬 Hub(http://localhost:3001/api/mcp/mejoras)를 가리키도록만 변경합니다.

MCP_MEJORAS_TOKEN이 없으면 브리지는 시작하지 않습니다. 어떤 변수가 빠졌는지 알리면서 코드 1로 종료합니다. 의도적입니다. 토큰 없이 시작되는 브리지는 클라이언트가 모든 요청에 “권한 없음”이라고 응답하는 서버를 갖게 만들고, 그것은 “Hub가 다운되었다”로 읽힙니다. 잘못된 곳을 보게 만듭니다.

⚠️ MCP_MEJORAS_TOKEN은 MCP_BLOG_TOKEN이나 MCP_API_TOKEN이 아닙니다. 서로 다른 세 개의 게이트에 대한 세 개의 서로 다른 비밀값입니다.

tools로 무엇을 할 수 있나

서버가 부과하는 두 가지 규칙입니다. 이 브리지가 아닙니다.

• resumen_humano는 코드를 보지 못하는 사람에게 무엇이 변경되었는지 말해 주어야 합니다. 일반적인 요약은 실제로 유용한 것의 예시와 함께 거부됩니다.

• estado = 'desplegada'는 증거를 요구합니다. 증거 없는 초록색 배지는 바로 이 패널이 막기 위해 존재하는 것입니다.

보안

• 비밀값은 경로가 아닌 헤더로 전송됩니다. 게이트는 두 가지 형태를 모두 수용합니다 — Cowork가 헤더를 보낼 수 없기 때문에 경로도 존재합니다 — 하지만 경로는 서버의 액세스 로그에 남게 되며, 로컬 프로세스는 그 비용을 치를 필요가 없습니다. 이를 검증하는 테스트가 있습니다.

• stdout에는 JSON-RPC 메시지만 출력됩니다. 나머지는 모두 stderr로 갑니다. stdout의 다른 어떤 것도 클라이언트가 프로토콜로 읽고 연결을 닫습니다.

• 공유 토큰이며 /mejoras/conectar에서 교체할 수 있습니다. 데이터베이스 자격 증명이 아니며, 이 게이트의 어떤 tool도 CRM에 쓰지 않습니다.

개발

npm test    # 13 tests, cero dependencias

테스트는 localhost에 있는 가짜 MCP 게이트를 대상으로 실행되며, 그중 두 개는 프로세스로서의 바이너리를 실행합니다 — 모듈이 아니라 — 깨진 shebang이나 잊은 console.log는 어떤 단위 테스트도 잡아내지 못하고, 클라이언트에서의 증상은 그저 “서버가 시작되지 않음”이기 때문입니다.

검증하는 내용: tools/list가 브리지가 tools를 만들거나 잘라내지 않고 온전히 통과하는지, 토큰이 URL에 나타나지 않는지, 알림이 응답을 생성하지 않는지, stdin의 두 조각으로 나뉜 메시지가 손상되지 않는지, SSE 응답이 keepalive ping을 무시하고 언랩되는지, 그리고 401 또는 500이 침묵 대신 사유와 함께 오류로 클라이언트에 도달하는지입니다.