Skip to main content

TeamAI MCP Server

Abdul Samad avatar
Written by Abdul Samad
Updated yesterday

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)

  1. Navigate to Settings in the sidebar

  2. Scroll to Integrations and click Add more

  3. Enter the following:

    1. Integration name: TeamAI

  4. Make sure to enable the tools in any new chats

Free/Pro (Claude Desktop App)

  1. Open the file ~/Library/Application Support/Claude/claude_desktop_config.json

  2. Add the following configuration

    { "mcpServers": { "teamai": { "command": "npx", "args": ["-y", "mcp-remote", "https://api.teamai.com/mcp/mcp", "--header", "Authorization:Bearer YOUR_API_TOKEN"] } }}

  3. Restart the Claude Desktop app

Cursor

  1. Open Cursor and go to SettingsMCP

  2. Click Add new global MCP server

  3. Add the following configuration

    { "mcpServers": { "teamai": { "command": "npx", "args": [ "mcp-remote", "https://api.teamai.com/mcp/mcp", "--header", "Authorization:Bearer YOUR_API_TOKEN" ] } }}

  4. 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.

  1. Navigate to Tools

    1. Go to your workspace

    2. Click on Tools in the sidebar

    3. Click Create Tool

  2. Select MCP Server

    1. Choose MCP Server as the tool type

    2. This provides a simplified interface optimized for MCP connections

  3. Configure Basic Information

    1. Name: Give your MCP server a descriptive name

    2. Description: Explain what data or services this MCP server provides

    3. Group: Optionally organize into folders for better management

  4. Set the MCP Server URL

    1. MCP Server URL: Enter your MCP server endpoint

  5. Configure Headers (if needed)

    1. Click Add Header to configure authentication or custom headers

    2. Common headers: Authorization, Content-Type, Accept, User-Agent

    3. Hidden headers: Toggle on to securely store sensitive values like API keys

    4. Example: Authorization: Bearer your-api-token

Visual Studio Code

  1. Press Ctrl/Cmd + Shift + P and search for MCP: Add Server

  2. Select Command (stdio)

  3. Enter the following configuration

    npx mcp-remote https://api.teamai.com/mcp/mcp --header "Authorization:Bearer YOUR_API_TOKEN"

  4. Enter the name TeamAI and press Enter

  5. Activate using MCP: List ServersTeamAIStart Server

Windsurf

  1. Press Ctrl/Cmd + , to open settings

  2. Navigate to CascadeMCP servers

  3. Select Add ServerAdd custom server

  4. 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

  1. Press Cmd + , to open settings

  2. 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

  1. Log into your TeamAI workspace

  1. Navigate to SettingsAPI Keys

  1. Click Generate New API Key

  1. Copy the generated Bearer token

  1. 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


Did this answer your question?