Welcome to MCP Gateway Discussions Page!

[crivetimihai]

👋 Welcome to the MCP Gateway community!

Have a question, an idea, or hit a snag? Open a Discussion and we'll figure it out together. 🚀

📂 Categories

Category	What belongs here?
❓ Q&A / Troubleshooting	Build/runtime errors, “how do I…?”
🔧 Installation Help	Container, env-vars, DB driver issues
💡 Feature Proposals	New gateway capabilities, UI tweaks
🚀 Show & Tell	Demos, blog posts, screenshots
🧩 Integrations & Adapters	Wrapping external REST APIs, federation stories
🗣️ General Chat	Meet-ups, memes, anything else

---

🙋‍♂️ Asking a great question

1. Search first (🔍 above).
2. Pick the right category.
3. Add: Gateway version, Docker tag / OS, Python version, exact command, and a short log or stack-trace (use triple back-ticks).
4. Mark the thread answered when you're sorted.

---

🛠️ Quick troubleshooting checklist

Symptom	Fix
psycopg2 install fails	Not using Postgres? pip uninstall psycopg2-binary
sqlite3.OperationalError: database is locked	Switch to Postgres/MySQL via DATABASE_URL=
Admin UI won't load	Ensure MCPGATEWAY_UI_ENABLED=true and hit http://host:4444/admin
401 on API requests	Regenerate your JWT via create_jwt_token and pass Authorization: Bearer <token>

If that doesn't help, open a ❓ Q&A / Troubleshooting topic with the details above.

---

✨ Contributing

Big feature in mind? Start a 💡 Feature Proposal first so we can align on design and scope. Tiny fixes (typos, log tweaks) can go straight to a PR.

🏁 Quick start — pre-built container

# 1. Run the gateway
docker run -d --name mcpgateway \
  -p 4444:4444 \
  -e HOST=0.0.0.0 \
  -e JWT_SECRET_KEY=my-secret-key \
  -e BASIC_AUTH_USER=admin \
  -e BASIC_AUTH_PASSWORD=changeme \
  -e AUTH_REQUIRED=true \
  -e DATABASE_URL=sqlite:///./mcp.db \
  ghcr.io/ibm/mcp-context-forge:latest

# 2. Create an admin token (7 days)
docker exec mcpgateway python3 -m mcpgateway.utils.create_jwt_token \
  --username admin --exp 10080 --secret my-secret-key

# 3. Smoke-test
export TOKEN=<paste-your-token>
curl -s -H "Authorization: Bearer $TOKEN" http://localhost:4444/health

The create_jwt_token helper lives at mcpgateway/utils/create_jwt_token.py .

Tip: swap the long list of -e flags for --env-file .env once you have a config file.