planka/gitea-mcp-memory.md

Gitea MCP Memory - Key Lessons

NEVER DO AGAIN:

• ❌ Use fetch_url_content() for MCP endpoints (always returns 405)
• ❌ Add readme to create_repo() requests (causes MaxSize error)
• ❌ Expect terminal output capture from git commands in remote env
• ❌ Assume HTTP GET works on /mcp path (MCP requires protocol connections)

ALWAYS DO:

• ✅ Use MCP tools directly (list_my_repos, create_repo, etc.)
• ✅ Use wiki_write for documentation instead of repo readme
• ✅ Restart IDE after mcpServers/mcp.json updates
• ✅ Verify with netstat before assuming connectivity

Known URLs:

• API: http://192.168.1.122/api/v1/*
• Web UI: http://192.168.1.122
• MCP endpoint: http://192.168.1.122:30008/mcp

Proof of Working Connection:

• Repo created: AhmedTawfik/gitea-temp-repo-dummy
• MCP tools operational after IDE restart