# MCP Hosting & Proxying — 官方帮助文档存档

> 来源：https://docs.gumloop.com/enterprise-features/hosted_mcps.md + https://docs.gumloop.com/enterprise-features/proxied_mcps.md
> 抓取日期：2026-05-30
> 状态：✅ 完整

---

## Hosted MCPs

Build and deploy custom MCP servers on Gumloop's infrastructure from GitHub repos. Enterprise-only. Full lifecycle management: build, deploy, monitor, route requests.

### Setup
- GitHub OAuth (Personal): per-developer, allows repo creation
- GitHub App (Organization): one-time, enables auto-deploy on push to main

### Creation (3-step wizard)
1. Basic Info: name, description, repo, visibility
2. Auth: None / API Key / OAuth 2.0 + environment variables (developer secrets)
3. Review & Create → Gumloop creates repo with boilerplate, registers server

### Server Detail (6 tabs)
- **Overview**: 7-day snapshot (calls, users, error rate, latency), MCP Server URL, live deployment info
- **Tools**: Custom-role matrix (toggle per tool per role, disable server per role)
- **Activity**: Histogram with latency color coding (P25 green, P85-95 orange, P95+ red), export CSV
- **Deployments**: History (Building/Deploying/Live/Ready/Failed/Rolled Back), manual deploy from branch/commit
- **Monitoring**: Active pods, pod restarts, live streaming runtime logs
- **Settings**: Image, name, description, env vars, disable/delete server

## Proxied MCPs

Connect external MCP servers through Gumloop's managed proxy — no code deployment, just provide URL.

### Key Differences vs Hosted
| | Hosted | Proxied |
|---|---|---|
| Code deploy | Yes (GitHub) | No (URL only) |
| Where runs | Gumloop infra | Third-party infra |
| Deployment monitoring | Yes (pods/logs) | No |
| Activity tracking | Yes | Yes |
| Tool access control | Yes | Yes |

### Connection (3-step wizard)
1. Enter URL → Gumloop probes server capabilities
2. Configure: name, auth method (None/API Key/OAuth 2.0), UI/Raw toggle for config
3. Discover & Activate: detect tools/resources, add credentials, summary of discovered tools

### Server Detail (4 tabs)
- Overview: 7-day snapshot, proxy URL, routing status (Live when reachable), Fetch New Tools button
- Tools: Custom-role matrix
- Activity: Same histogram + table as Hosted
- Settings: Name, description, URL, disable/delete

### Key Details
- Embedded credentials auto-redacted in UI
- Only HTTP-based transports (Streamable HTTP or SSE)
- External server doesn't need Gumloop awareness
- Auto-reconnect on recovery after outage
- Auth method fixed at creation (delete/recreate to change)
