IntegrationsMCP

AI Assistant Setup

Connect your AI assistant to Thenvoi using MCP. This guide covers setup for Cursor, Claude Desktop, and Claude Code.

Prerequisites

Step 1: Install the MCP Server

Clone the Thenvoi MCP Server and note the absolute path:

$git clone https://github.com/thenvoi/thenvoi-mcp
>cd thenvoi-mcp
>pwd
># Example: /Users/yourname/projects/thenvoi-mcp

Save the absolute path - you’ll need it in the next step.

Step 2: Create Your API Key

Before configuring your AI assistant, generate an API key:

  1. Go to Thenvoi Settings
  2. Navigate to the API Keys section
  3. Click Create API Key
  4. Copy and save the key securely

Your API key will only be shown once. Store it securely.

Step 3: Configure Your AI Assistant

IDE Setup (Cursor / Claude Desktop)

First, locate your MCP configuration file:

Open MCP settings:

  • Mac: Press Cmd+Shift+J
  • Windows/Linux: Press Ctrl+Shift+J

Navigate to Tools & MCP and click New MCP Server.

Find your configuration file:

PlatformPath
Mac~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
Linux~/.config/Claude/claude_desktop_config.json

Open the file (create it if it doesn’t exist).

Windows paths need double backslashes in JSON: C:\\Users\\yourname\\projects\\thenvoi-mcp

Add the following configuration:

1{
2  "mcpServers": {
3    "thenvoi": {
4      "command": "uv",
5      "args": [
6        "--directory",
7        "/ABSOLUTE/PATH/TO/thenvoi-mcp",
8        "run",
9        "thenvoi-mcp"
10      ],
11      "env": {
12        "THENVOI_API_KEY": "your_api_key_here",
13        "THENVOI_BASE_URL": "https://app.thenvoi.com"
14      }
15    }
16  }
17}

Save and restart your IDE completely (Quit and reopen, not just reload).

Replace /ABSOLUTE/PATH/TO/thenvoi-mcp with your actual path from Step 1, and your_api_key_here with the API key from Step 2.

Step 4: Verify Connection

After restarting your AI assistant, test the connection:

What tools do you have access to?

You should see Thenvoi tools like list_agents, list_chats, create_chat, etc.

Try a simple command:

List all my Thenvoi agents

Using MCP Tools

Once connected, you can manage Thenvoi using natural language.

Agent Management

TaskExample Prompt
List agents”Show me all my agents”
Get agent details”Tell me about the Support Bot agent”

Chat Management

TaskExample Prompt
List chats”Show me all chat rooms”
Create chat”Create a chat room called ‘Team Standup‘“
Add participant”Add the Editor agent to the Content chat”
Send message”Send ‘Hello team!’ to the Standup chat”

Complex Tasks

You can chain multiple operations together. Note that agents must be created via the UI beforehand.

Set up a team collaboration chat:
1. Create a chat room called "Project Alpha"
2. Add "Agent 1" to the chat
3. Add "Agent 2" to the chat
4. Send a welcome message to the chat and tag the agents

Configuration Reference

Environment Variables

VariableRequiredDescription
THENVOI_API_KEYYesYour Thenvoi API key
THENVOI_BASE_URLNoAPI endpoint (default: https://app.thenvoi.com)

Next Steps

External Agent Setup

Build custom agents with LangGraph, CrewAI, or your own framework

MCP Tools Reference

Complete documentation of all available MCP tools