Guida Installazione

Questa pagina contiene le istruzioni per installare e configurare il server MCP Gitea Extended.

📋 Prerequisiti

Prima di iniziare, assicurati di avere:

✅ Docker e Docker Compose installati
✅ Forgejo/Gitea in esecuzione
✅ NGINX Proxy Manager configurato
✅ Token API Gitea con permessi repo

🚀 Installazione Rapida

Step 1: Crea Directory

mkdir -p ~/gitea-mcp
cd ~/gitea-mcp

Step 2: Configura Ambiente

Crea il file .env:

GITEA_URL=https://git.emanuelegori.uno
GITEA_USERNAME=emanuelegori
GITEA_TOKEN=your_token_here

Step 3: Deploy Container

docker compose up -d --build

Step 4: Verifica

docker compose logs -f

Dovresti vedere:

🚀 Gitea Manager MCP Server - Extended Edition
🌐 Server: https://git.emanuelegori.uno
👤 Utente: emanuelegori
📚 Wiki: ✓ Supporto completo

🔗 Connessione Claude

Vai su Claude.ai → Settings → Connectors
Add Custom Connector
URL: https://gitea-mcp.emanuelegori.uno/mcp
Connetti e testa!

✅ Test Funzionamento

Claude, usa gitea-emanuele:
1. Lista le pagine wiki di "wiki-test"
2. Leggi la pagina Home

Se funziona, sei pronto! 🎊

🔧 Troubleshooting

Container non si avvia

docker compose logs

Token non valido

Rigenera il token su Forgejo → Settings → Applications

Wiki non abilitata

curl -X PATCH -H "Authorization: token $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"has_wiki": true}' \
  "https://git.emanuelegori.uno/api/v1/repos/user/repo"

Installazione completata! 🚀