Connecting External AI Tools via MCP

Septra natively supports the open Model Context Protocol (MCP) standard, exposing high-throughput streamable-HTTP endpoints that allow external AI clients—including Claude Code (CLI), Claude Desktop, and Cursor IDE—to search workspace knowledge bases, consult domain specialists, trigger generative workflows, and manage deliverables directly from your development environment.

---

1. Architecture: Dedicated Regional MCP API#

Septra's MCP architecture runs on a dedicated regional REST API Gateway with streaming transfer mode (responseTransferMode: STREAM), bypassing edge CloudFront timeouts and giving tools up to 120 seconds to complete complex reasoning cycles:

| :--- | :--- | :--- | :--- |

[!IMPORTANT]
The MCP endpoints live on `mcp.septra.ai` (or mcp-dev.septra.ai in staging), not on the main api.septra.ai domain. Token exchange and Hosted UI OAuth are routed via api.septra.ai/oauth/*, while RFC 9728 discovery is available directly at https://mcp.septra.ai/.well-known/oauth-protected-resource.

---

2. Workspace MCP Tool Directory#

When connected to https://mcp.septra.ai/mcp, your client receives real-time access to over 25 specialized workspace tools categorized across five capability areas:

A. Workforce Collaboration & Specialists#

ask_agent: Communicate directly with any agent persona (e.g. Sage CMO, Aria Paid Ads Optimizer, Gale Growth Lead, Elana Business Analyst).
consult_specialist: Query specialized personas for rapid feedback on specific deliverables.
delegate_mission: Dispatch an autonomous mission to an agent team for asynchronous execution.
list_specialists: Discover all active and deployed agents in the workspace.
check_inbox: Review tasks and pending approvals awaiting human action.

B. Knowledge & Intelligence Search#

search_knowledge_base: Semantic vector retrieval across indexed workspace documents, uploaded brand assets, and customer personas with citation snippets.
list_intelligence_sources: Check connection status of Google Ads, GA4, Search Console, HubSpot, Odoo, and Social accounts.
manage_intelligence_source: Configure or refresh intelligence connector credentials.

C. Creative & Marketing Generation#

generate_blog_post: Draft long-form, SEO/GEO-optimized blog content grounded in real performance data.
generate_ugc_video: Produce scripted avatar video specifications for HeyGen or Hyperframes rendering.
generate_image: Create brand-aligned marketing imagery and visual assets.
create_social_post: Draft multi-platform social announcements for LinkedIn, X, and Instagram.

D. Deliverables & Approval Lifecycle#

list_deliverables: Retrieve all deliverables filtered by status (in_review, approved, published).
get_deliverable: Inspect complete deliverable content, metadata, and agent review notes.
update_deliverable_status: Transition deliverables between draft, review, and approved states.
approve_deliverable: Grant human sign-off to dispatch changes to live advertising accounts, CMS platforms, or social channels.

E. Audits & Competitor Intelligence#

run_marketing_audit: Trigger an on-demand audit across Paid Ads, SEO health, or Generative AI visibility.
get_competitor_digest: Retrieve scraped updates and strategic moves from tracked industry competitors.
manage_competitors: Add or adjust tracked competitor websites and target domains.

---

3. Connecting to Claude Code (CLI)#

The Claude Code command-line interface natively supports streamable HTTP MCP transport and OAuth 2.0 with PKCE:

Step 1: Add the MCP Endpoint#

In your terminal, run the following command:

claude mcp add --transport http septra https://mcp.septra.ai/mcp

*(For staging/develop environments, use https://mcp-dev.septra.ai/mcp)*

Step 2: Complete Browser OAuth#

Claude Code will automatically detect the OAuth requirement and prompt you to open the authentication URL.
Sign in with your workspace credentials.
Upon successful authorization, Claude Code records your local token and displays a green confirmation status.

Step 3: Example Prompts#

Once connected, Claude Code can invoke Septra workspace tools directly during your coding workflow:

# Query workspace knowledge base
claude "Search our Septra knowledge base for our brand voice guidelines and target ICP"

# Delegate an audit mission
claude "Delegate a mission to Aria to review our Google Ads CPA across Q3 campaigns"

# Inspect pending deliverables
claude "List all deliverables currently in review and show me the latest SEO blog draft"

---

4. Connecting to Claude Desktop#

Claude Desktop communicates via standard input/output (stdio). You can bridge Claude Desktop to Septra's streamable HTTP endpoint using mcp-remote:

Step 1: Verify Prerequisites#

Ensure Node.js 18+ is installed on your workstation.

Step 2: Edit Claude Desktop Configuration#

Open your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the septra entry inside mcpServers:

{
  "mcpServers": {
    "septra": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "--streamable-http",
        "https://mcp.septra.ai/mcp"
      ]
    }
  }
}

Step 3: Restart Claude Desktop#

Quit and reopen Claude Desktop. The hammer icon in the prompt input will now display the available Septra tools.

---

5. Connecting to Cursor IDE#

Cursor IDE supports direct HTTP and Server-Sent Events MCP connections:

Open Cursor Settings > Features > MCP.
Click + Add New MCP Server.
Enter the following parameters:
- Name: septra
- Type: command (or SSE / HTTP depending on Cursor version)
- Command: npx -y mcp-remote@latest --streamable-http https://mcp.septra.ai/mcp
Click Save. When the status dot turns green, Cursor's Composer and Agent modes can leverage Septra tools to ground architectural decisions in your real production metrics.

---

6. Platform Admin Control Plane (`/admin`)#

For workspace operators and platform administrators with the super_admin Cognito role, Septra provides a dedicated control-plane endpoint:

claude mcp add --transport http septra-admin https://mcp.septra.ai/admin

This endpoint exposes administrative tools with zero overlap to the workspace server, including tenant workspace lifecycle management, cross-workspace user provisioning, feature flag toggles, credit ledger adjustments, and direct agent redeployment triggers.