CloudEagle MCP — Setup Guide

1. Add CloudEagle to the Claude Desktop config
   Open the configuration file for your platform:

   macOS~/Library/Application Support/Claude/claude_desktop_config.json

   Windows%APPDATA%\Claude\claude_desktop_config.json

   If the file does not exist, create it. Add the following:

   Copy{
     "mcpServers": {
       "cloudeagle": {
         "type": "http",
         "url": "https://mcp.cloudeagle.ai/mcp"
       }
     }
   }

   Fully quit and reopen Claude Desktop.
2. Sign in via the browser
   On first use, Claude Desktop opens a browser window with the CloudEagle sign-in page. Enter your CloudEagle username and password, or click your company's SSO button (Google, Okta, Microsoft, etc.). Your session is stored automatically.
3. Verify the connection
   Open a new chat and type "What CloudEagle tools are available?"

1. Add CloudEagle to the Cursor MCP config
   Open or create .cursor/mcp.json in your home directory (or project root):

   Copy{
     "mcpServers": {
       "cloudeagle": {
         "url": "https://mcp.cloudeagle.ai/mcp"
       }
     }
   }

   Restart Cursor.
2. Sign in via the browser
   On first use, Cursor opens a browser window with the CloudEagle sign-in page. Enter your CloudEagle username and password, or click your company's SSO button (Google, Okta, Microsoft, etc.). Your session is stored automatically.
3. Verify the connection
   CloudEagle tools will be available in Cursor's AI assistant. Try: "List my CloudEagle applications."

1. Add CloudEagle in Windsurf Settings
   Open Windsurf Settings → MCP Servers → Add Server and fill in:

   TypeHTTP

   URLhttps://mcp.cloudeagle.ai/mcp

   Save and restart Windsurf.
2. Sign in via the browser
   On first use, Windsurf opens a browser window with the CloudEagle sign-in page. Enter your CloudEagle username and password, or click your company's SSO button (Google, Okta, Microsoft, etc.). Your session is stored automatically.
3. Verify the connection
   CloudEagle tools will be available in Windsurf's AI assistant. Try: "List my CloudEagle applications."

Automated agents (Claude API, LangChain, LangGraph, custom scripts) cannot open a browser for OAuth. Instead, pass a CloudEagle API key directly as a Bearer token — no OAuth dance required.

1. Get your CloudEagle API key
   Log in to CloudEagle → click your name in the top-right → View Profile → Generate API Key. Copy the key.
2. Configure your agent
   Pass the key as Authorization: Bearer in the MCP client headers. Replace {tenant} with your CloudEagle tenant slug.

   Anthropic Python SDK (claude-sdk agents)

   Copyimport anthropic
   
   client = anthropic.Anthropic()
   response = client.beta.messages.create(
       model="claude-opus-4-5",
       max_tokens=4096,
       tools=[{"type": "mcp", "server_label": "cloudeagle",
               "server_url": "https://mcp.cloudeagle.ai/{tenant}",
               "headers": {"Authorization": "Bearer YOUR_API_KEY"}}],
       messages=[{"role": "user", "content": "List my SaaS applications."}],
       betas=["mcp-client-2025-04-04"],
   )

   Python MCP SDK

   Copyfrom mcp.client.streamable_http import streamablehttp_client
   
   async with streamablehttp_client(
       "https://mcp.cloudeagle.ai/{tenant}",
       headers={"Authorization": "Bearer YOUR_API_KEY"}
   ) as (read, write, _):
       # tools are discovered automatically
       ...

   TypeScript / Node

   Copyimport { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
   
   const transport = new StreamableHTTPClientTransport(
     new URL("https://mcp.cloudeagle.ai/{tenant}"),
     { requestInit: { headers: { "Authorization": "Bearer YOUR_API_KEY" } } }
   );

   Claude Code (agent mode, no browser)

   Copy# ~/.claude/mcp.json
   {
     "mcpServers": {
       "cloudeagle": {
         "type": "http",
         "url": "https://mcp.cloudeagle.ai/{tenant}",
         "headers": { "Authorization": "Bearer YOUR_API_KEY" }
       }
     }
   }

1. Get your CloudEagle API key
   Log in to CloudEagle → click your name in the top-right → View Profile → Generate API Key. Copy the key.
2. Connect using the MCP SDK
   Pass your API key as a Bearer token in the Authorization header:

   Python

   Copyfrom mcp.client.streamable_http import streamablehttp_client
   
   async with streamablehttp_client(
       "https://mcp.cloudeagle.ai/mcp",
       headers={"Authorization": "Bearer YOUR_API_KEY"}
   ) as (read, write, _):
       # tools are discovered automatically
       ...

   TypeScript

   Copyimport { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
   
   const transport = new StreamableHTTPClientTransport(
     new URL("https://mcp.cloudeagle.ai/mcp"),
     { requestInit: { headers: { "Authorization": "Bearer YOUR_API_KEY" } } }
   );