The TeamAI MCP (Model Context Protocol) server provides a standardized interface that allows any compatible AI model or agent to programmatically access and manage your TeamAI workspace data, including agents, tools, and configurations.
Connect to our MCP server using the streamable HTTP transport in Cursor, Windsurf, Claude Desktop, and other MCP-compatible clients to seamlessly integrate TeamAI's powerful agent management capabilities into your development workflow.
Transport Support
Current: Streamable HTTP (/api/mcp/mcp)
Setup Instructions
> Note: Remote MCP connections are still evolving technology. If you experience connection issues, try restarting your client or temporarily disabling and re-enabling the TeamAI MCP server.
Claude Desktop
Team/Enterprise (Claude.ai)
Navigate to Settings in the sidebar
Scroll to Integrations and click Add more
Enter the following:
Integration name: TeamAI
Integration URL: https://api.teamai.com/mcp/mcp
Make sure to enable the tools in any new chats
Free/Pro (Claude Desktop App)
Open the file ~/Library/Application Support/Claude/claude_desktop_config.json
Add the following configuration
{ "mcpServers": { "teamai": { "command": "npx", "args": ["-y", "mcp-remote", "https://api.teamai.com/mcp/mcp", "--header", "Authorization:Bearer YOUR_API_TOKEN"] } }}
Restart the Claude Desktop app
Cursor
Open Cursor and go to Settings → MCP
Click Add new global MCP server
Add the following configuration
{ "mcpServers": { "teamai": { "command": "npx", "args": [ "mcp-remote", "https://api.teamai.com/mcp/mcp", "--header", "Authorization:Bearer YOUR_API_TOKEN" ] } }}
Restart Cursor to activate the connection
TeamAI
You can also connect external MCP servers as tools within your TeamAI workspace, allowing your agents to access external data sources and services.
Navigate to Tools
Go to your workspace
Click on Tools in the sidebar
Click Create Tool
Select MCP Server
Choose MCP Server as the tool type
This provides a simplified interface optimized for MCP connections
Configure Basic Information
Name: Give your MCP server a descriptive name
Description: Explain what data or services this MCP server provides
Group: Optionally organize into folders for better management
Set the MCP Server URL
MCP Server URL: Enter your MCP server endpoint
Configure Headers (if needed)
Click Add Header to configure authentication or custom headers
Common headers: Authorization, Content-Type, Accept, User-Agent
Hidden headers: Toggle on to securely store sensitive values like API keys
Example: Authorization: Bearer your-api-token
Visual Studio Code
Press Ctrl/Cmd + Shift + P and search for MCP: Add Server
Select Command (stdio)
Enter the following configuration
npx mcp-remote https://api.teamai.com/mcp/mcp --header "Authorization:Bearer YOUR_API_TOKEN"
Enter the name TeamAI and press Enter
Activate using MCP: List Servers → TeamAI → Start Server
Windsurf
Press Ctrl/Cmd + , to open settings
Navigate to Cascade → MCP servers
Select Add Server → Add custom server
Add the following configuration
{ "mcpServers": { "teamai": { "command": "npx", "args": ["-y", "mcp-remote", "https://api.teamai.com/mcp/mcp", "--header", "Authorization:Bearer YOUR_API_TOKEN"] } }}
Zed
Press Cmd + , to open settings
Add the following to your configuration
{ "context_servers": { "teamai": { "command": { "path": "npx", "args": ["-y", "mcp-remote", "https://api.teamai.com/mcp/mcp", "--header", "Authorization:Bearer YOUR_API_TOKEN"], "env": {} }, "settings": {} } }}
Other MCP Clients
For any other MCP-compatible client, use these settings:
Command: npx
Arguments:
-y mcp-remote https://api.teamai.com/mcp/mcp --header "Authorization:Bearer YOUR_API_TOKEN"
Environment: None required
Transport Type: Streamable HTTP
Getting Your API Token
Log into your TeamAI workspace
Navigate to Settings → API Keys
Click Generate New API Key
Copy the generated Bearer token
Replace YOUR_API_TOKEN in the configurations above with your actual token
Example Usage
Once configured, you can interact with TeamAI directly through your MCP client:
"List all my agents" → Returns paginated list of workspace agents
"Create a new agent called 'Code Reviewer' that specializes in reviewing
JavaScript code" → Creates and configures the agent automatically
"Show me details about agent ID abc123" → Retrieves complete agent configuration
"Update my agent to use GPT-4 instead of GPT-3.5" → Modifies agent model settings