Skip to main content
Glama

honcho-mcp-web

Remote MCP server (HTTP/OAuth) exposing a self-hosted Honcho instance to claude.ai custom connectors and other MCP clients (Codex, Copilot, etc).

Two pieces run in the same container:

  • vendor/honcho-mcp (git submodule, upstream: devstroop/honcho-mcp) — the actual MCP tool implementations (peers, sessions, conclusions, workspace, dream/queue). Runs on localhost:3000, not exposed outside the container.

  • src/ (this repo) — a minimal single-user OAuth 2.1 (PKCE + Dynamic Client Registration) authorization server plus a token admin panel (/admin, HTTP Basic Auth), sitting in front of the upstream and proxying only authenticated requests to it. Each issued token (OAuth-issued for claude.ai, or a static token minted from /admin for CLI-style clients) is bound to an identity (workspace / peer / ai_peer) that the gateway enforces server-side on every tools/call.

Env vars

Variable

Default

Description

HONCHO_API_URL

http://api:8000

Self-hosted Honcho backend URL (passed to the upstream submodule)

HONCHO_API_KEY

—

API key for the Honcho backend

HONCHO_WORKSPACE_ID

default

Workspace the upstream operates in

PUBLIC_URL

http://localhost:8802

Public URL of this gateway (used in OAuth metadata)

GATEWAY_PASSWORD

—

Password for /authorize consent and /admin Basic Auth

HONCHO_PEER

leandro-sampaio

Default human peer shown in token forms

PORT

8802

Gateway listen port

Related MCP server: Remote MCP Server on Cloudflare

Updating the upstream

git submodule update --remote vendor/honcho-mcp
git add vendor/honcho-mcp
git commit -m "Atualiza devstroop/honcho-mcp"

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      A Model Context Protocol server implementation designed to run on Cloudflare Workers with integrated OAuth authentication. It enables hosting and securely accessing MCP tools remotely via SSE transport from clients like Claude Desktop.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Private OAuth-backed MCP server for ChatGPT, supporting GPT Apps via MCP Streamable HTTP and GPT Actions via REST endpoints with OpenAPI 3.1.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude.ai to connect to a Hermes MCP server via OAuth 2.1 authorization code flow with PKCE, acting as a reverse proxy and single-user authorization gateway.
      -