Cloud Tools Gateway

Remote MCP tools server built with Python, FastMCP, Streamable HTTP, and static bearer-token authentication.

Local Development

uv sync
$env:MCP_BEARER_TOKEN = "replace-with-a-long-random-secret"
uv run uvicorn main:app --host 0.0.0.0 --port 8000

MCP endpoint:

http://localhost:8000/mcp

Clients must send:

Authorization: Bearer replace-with-a-long-random-secret

For ChatGPT custom connectors, use OAuth authentication. The server exposes:

• Authorization metadata: /.well-known/oauth-authorization-server
• Authorization URL: /oauth/authorize
• Token URL: /oauth/token
• MCP resource: /mcp

Set PUBLIC_BASE_URL in production, for example https://mcp-dh2a.onrender.com.

Tools

• fetch_webpage: fetches a URL and returns clean text plus page metadata.
• extract_links: extracts normalized links from a URL.
• check_url_status: checks URL reachability, status, timing, and headers.
• analyze_text: returns basic text statistics and top terms.
• run_crewai_automation: sends an order to a configured CrewAI deployment.
• call_crewai_endpoint: calls safe GET/POST paths on the configured CrewAI deployment API.

Docker

Build:

docker build -t cloud-tools-gateway .

Run:

docker run --rm -p 8000:8000 -e MCP_BEARER_TOKEN="replace-with-a-long-random-secret" cloud-tools-gateway

Cloud Deployment

Use these settings on Render, Railway, Fly.io, Google Cloud Run, or a similar container host:

• Build command: docker build -t cloud-tools-gateway .
• Run command: uv run --frozen uvicorn main:app --host 0.0.0.0 --port $PORT
• Required environment variable: MCP_BEARER_TOKEN
• Recommended environment variable: PUBLIC_BASE_URL
• Optional environment variable: MCP_CLIENT_ID
• Optional CrewAI bridge variables: CREWAI_API_URL, CREWAI_BEARER_TOKEN
• Public MCP URL: https://<your-domain>/mcp

For container platforms that run the Dockerfile directly, set only MCP_BEARER_TOKEN; the CMD is already included.

CrewAI

CrewAI can connect to the same remote MCP endpoint with direct bearer-token headers.

Install CrewAI MCP support in your agent project:

uv add crewai

Set environment variables:

export MCP_URL="https://mcp-dh2a.onrender.com/mcp"
export MCP_BEARER_TOKEN="your-render-mcp-token"

Use examples/crewai_remote_mcp.py as a starting point. The key configuration is:

from crewai.mcp import MCPServerHTTP

tools = MCPServerHTTP(
    url="https://mcp-dh2a.onrender.com/mcp",
    headers={"Authorization": f"Bearer {MCP_BEARER_TOKEN}"},
    cache_tools_list=True,
)

ChatGPT To CrewAI Bridge

To let ChatGPT give orders to a CrewAI deployment through this MCP server, configure these environment variables on the MCP deployment:

CREWAI_API_URL="https://your-crew-deployment.crewai.com"
CREWAI_BEARER_TOKEN="your-crewai-deployment-bearer-token"

After redeploying, refresh the ChatGPT connector actions. ChatGPT will see:

• run_crewai_automation: starts the configured CrewAI deployment via /kickoff.
• call_crewai_endpoint: makes constrained GET/POST calls to the CrewAI deployment API.