From b7411b236eea8011263e1f09d651b76107036576 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 22 Aug 2026 04:29:14 +0000 Subject: [PATCH] docs(ai-stack): give exact claude mcp add commands for gitea-mcp Replace the vague "add it with claude mcp add" with real commands for both stdio (single local CLI) and HTTP (shared server) transport, verified against gitea/gitea-mcp's actual distribution (binary/Docker/ go run, -t stdio|http flags, GITEA_HOST/GITEA_ACCESS_TOKEN env vars). --- services/ai-stack.md | 23 ++++++++++++++++++----- 1 file changed, 18 insertions(+), 5 deletions(-) diff --git a/services/ai-stack.md b/services/ai-stack.md index bbdbd86..80cd26a 100644 --- a/services/ai-stack.md +++ b/services/ai-stack.md @@ -47,11 +47,24 @@ Two levels, depending on what you need: an arbitrary self-hosted Gitea on your LAN. - **PR/issue/CI-level integration (optional).** Reading/commenting on Gitea PRs and issues the way a GitHub MCP server does for GitHub needs an MCP - server that speaks Gitea's REST API. Gitea's own project publishes one - (`gitea/gitea-mcp`), authenticated via a personal access token — add it - with `claude mcp add` pointed at this stack's Gitea instance. Not bundled - by default; this stack's Gitea has no built-in Claude integration out of - the box. + server that speaks Gitea's REST API. Gitea's own project publishes one — + `gitea/gitea-mcp` (gitea.com/gitea/gitea-mcp) — as a binary release, a + Docker image (`docker.gitea.com/gitea-mcp-server`), or `go run + gitea.com/gitea/gitea-mcp@latest`; it supports both stdio and HTTP + transport. Generate a token first — this stack's Gitea → profile → + Settings → Applications → Generate New Token (repo/api scopes) — then: + ```bash + # stdio — simplest, one Claude Code CLI on this box + claude mcp add gitea --env GITEA_HOST=http://localhost:3001 \ + --env GITEA_ACCESS_TOKEN= -- gitea-mcp -t stdio + + # or HTTP — one server, shared by multiple Claude Code clients + gitea-mcp -t http --port 8090 & # run once, e.g. alongside the stack + claude mcp add gitea http://localhost:8090/mcp \ + --header "Authorization: Bearer " + ``` + Not bundled by default — this stack's Gitea has no built-in Claude + integration out of the box; this is you adding it. ## GPU switcher (small local GPU only) One small GPU can't run local chat and local image-gen at once. Swap it: