Knotie AI MCP

Knotie AI Pro MCP服务器

模型上下文协议（MCP）服务器，使Claude Desktop等AI代理能够与Knotie AI Pro平台进行交互，以实现自动化的客户和语音AI代理管理。

🚀 特性

• 客户管理：创建客户、启用门户访问、重置密码
• 代理管理：将AI代理映射到客户，更新配置，管理利润乘数
• 多平台支持：与Retell、VAPI、ElevenLabs、GoHighLevel合作
• 安全本地配置：API密钥存储在本地，从不传输给第三方
• Claude桌面集成：与Claude Desktop和其他MCP客户端无缝集成

📋 先决条件

• 已安装Node.js 18+
• 具有API访问权限的Knotie AI Pro合作伙伴帐户
• Claude Desktop或其他兼容MCP的客户端

🚀 快速开始

NPM用户（推荐）

# 1. Install globally
npm install -g knotie-ai-mcp

# 2. Run interactive setup
npm run setup
# OR manually create config:
mkdir -p ~/.knotie
echo '{"apiKey":"your-key","partnerEmail":"your-email@example.com","baseUrl":"https://knotie-ai.pro"}' > ~/.knotie/config.json

# 3. Test the server
npx knotie-ai-mcp

# 4. Add to Claude Desktop config and restart Claude

开发者（来源）

# 1. Clone and setup
git clone https://github.com/your-username/knotie-ai-mcp.git
cd knotie-ai-mcp
npm install && npm run build

# 2. Configure
cp config/knotie-config.example.json config/knotie-config.json
# Edit config/knotie-config.json with your credentials

# 3. Test
npm run dev

# 4. Add to Claude Desktop with full path to build/index.js

🛠️ 安装

# 1. Install globally
npm install -g knotie-ai-mcp

# 2. Run interactive setup
npm run setup
# OR manually create config:
mkdir -p ~/.knotie
echo '{"apiKey":"your-key","partnerEmail":"your-email@example.com","baseUrl":"https://knotie-ai.pro"}' > ~/.knotie/config.json

# 3. Test the server
npx knotie-ai-mcp

# 4. Add to Claude Desktop config and restart Claude

开发者（来源）

# 1. Clone and setup
git clone https://github.com/your-username/knotie-ai-mcp.git
cd knotie-ai-mcp
npm install && npm run build

# 2. Configure
cp config/knotie-config.example.json config/knotie-config.json
# Edit config/knotie-config.json with your credentials

# 3. Test
npm run dev

# 4. Add to Claude Desktop with full path to build/index.js

� 快速开始

NPM用户（推荐）

# 1. Install globally
npm install -g knotie-ai-mcp

# 2. Run interactive setup
npm run setup
# OR manually create config:
mkdir -p ~/.knotie
echo '{"apiKey":"your-key","partnerEmail":"your-email@example.com","baseUrl":"https://knotie-ai.pro"}' > ~/.knotie/config.json

# 3. Test the server
npx knotie-ai-mcp

# 4. Add to Claude Desktop config and restart Claude

开发者（来源）

# 1. Clone and setup
git clone https://github.com/your-username/knotie-ai-mcp.git
cd knotie-ai-mcp
npm install && npm run build

# 2. Configure
cp config/knotie-config.example.json config/knotie-config.json
# Edit config/knotie-config.json with your credentials

# 3. Test
npm run dev

# 4. Add to Claude Desktop with full path to build/index.js

🛠️ 安装

选项1:NPM安装（推荐）

# Install globally
npm install -g knotie-ai-mcp

# Or install locally
npm install knotie-ai-mcp

全局安装故障排除

如果在全局安装时遇到权限错误，您有几个选项：

选项A：使用npm的前缀标志（推荐）

# Create a directory for global packages
mkdir -p ~/npm-packages

# Install with custom prefix
npm install --prefix ~/npm-packages -g knotie-ai-mcp

# Add to your PATH (add this line to your ~/.bashrc or ~/.zshrc)
export PATH="$HOME/npm-packages/bin:$PATH"

选项B：配置npm以使用其他目录

# Create directory and configure npm
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global

# Add to your PATH (add this line to your ~/.bashrc or ~/.zshrc)
export PATH="$HOME/.npm-global/bin:$PATH"

# Then install
npm install -g knotie-ai-mcp

选项C：使用npx（无需安装）

# Run directly with npx
npx knotie-ai-mcp

选项2：来源

# Clone the repository
git clone https://github.com/knotie-ai/knotie-ai-mcp.git
cd knotie-ai-mcp

# Install dependencies
npm install

# Build the project
npm run build

⚙️ 配置

MCP服务器需要您的Knotie AI Pro API证书。您可以通过两种方式进行配置：

方法1：环境变量（推荐）

直接在Claude Desktop配置中设置环境变量：

{
  "mcpServers": {
    "knotie-ai-pro": {
      "command": "node",
      "args": ["/absolute/path/to/knotie-ai-mcp/build/index.js"],
      "env": {
        "KNOTIE_API_KEY": "your-api-key-here",
        "KNOTIE_PARTNER_EMAIL": "your-partner-email@example.com",
        "KNOTIE_BASE_URL": "https://analytics.knotie-ai.pro"
      }
    }
  }
}

环境变量：

• KNOTIE_API_KEY -您的合作伙伴API密钥（必需）
• KNOTIE_PARTNER_EMAIL -您的注册合作伙伴电子邮件（必填）
• KNOTIE_BASE_URL -分析服务的基本URL（可选，默认为https://analytics.knotie-ai.pro)

优点：

• ✅ 不需要配置文件
• ✅ 安全存储在Claude Desktop中的凭据
• ✅ 适用于任何安装方法
• ✅ 与其他MCP服务器（GitHub等）类似

方法2：配置文件（备选）

选项A:NPM安装

如果您是通过NPM安装的(npm install -g knotie-ai-mcp):

1. 创建配置目录：

   mkdir -p ~/.knotie

1. 创建配置文件：

   # Create the config file
   touch ~/.knotie/config.json

1. 添加您的凭据：

   {
     "apiKey": "your-api-key-here",
     "partnerEmail": "your-partner-email@example.com",
     "baseUrl": "https://analytics.knotie-ai.pro"
   }

方法2：从源（克隆存储库）

如果克隆了存储库：

1. 复制示例配置：

   cp config/knotie-config.example.json config/knotie-config.json

1. 编辑配置：

   # Edit the file with your credentials
   nano config/knotie-config.json
   # or
   code config/knotie-config.json

1. 更新您的凭据：

   {
     "apiKey": "your-actual-api-key",
     "partnerEmail": "your-actual-email@example.com",
     "baseUrl": "https://analytics.knotie-ai.pro"
   }

配置文件位置（优先级顺序）

服务器按以下顺序查找配置：

1. ./knotie-config.json （当前目录）
2. ~/.knotie/config.json （主目录）- 建议用于NPM安装
3. ./config/knotie-config.json （相对于安装）- 对于源安装

获取您的API凭据

1. 登录您的Knotie AI Pro合作伙伴仪表板
2. 导航到“设置”→ API密钥
3. 创建新的API密钥
4. 将API密钥和合作伙伴电子邮件复制到配置文件

🔧 Claude桌面设置

1.安装克劳德桌面

下载并安装 克劳德桌面 如果你还没有。

2.配置克劳德桌面

编辑您的Claude Desktop配置文件：

macOS/Linux：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

窗户：

code %APPDATA%\Claude\claude_desktop_config.json

3.添加Knotie AI Pro服务器

选项A：环境变量（推荐）

{
  "mcpServers": {
    "knotie-ai-pro": {
      "command": "node",
      "args": ["/Users/avijitsarkar/Projects/Knotie-AI/knotie-ai-pro/knotie-ai-mcp/build/index.js"],
      "env": {
        "KNOTIE_API_KEY": "pkt_48405b5a31fec30a3be3480f7d2a56552488bb61fc81d63100ab83e8d792d3b6",
        "KNOTIE_PARTNER_EMAIL": "avijeett007@gmail.com",
        "KNOTIE_BASE_URL": "https://analytics.knotie-ai.pro"
      }
    }
  }
}

选项B：使用配置文件安装NPM

{
  "mcpServers": {
    "knotie-ai-pro": {
      "command": "npx",
      "args": ["knotie-ai-mcp"]
    }
  }
}

选项C：来自配置文件的源代码

{
  "mcpServers": {
    "knotie-ai-pro": {
      "command": "node",
      "args": ["/absolute/path/to/knotie-ai-mcp/build/index.js"]
    }
  }
}

注： 替换 /absolute/path/to/knotie-ai-mcp 使用克隆存储库的实际路径。

为什么是index.js？ TypeScript源代码(src/index.ts)被编译为JavaScript(build/index.js)在构建过程中。Node.js运行编译后的JavaScript文件。

4.重新启动克劳德桌面

重新启动Claude Desktop以加载新的MCP服务器。

🎯 可用工具

系统工具

• 获得能力：获取系统功能和可用功能
• 获得健康：检查API运行状况

客户管理

• 创建客户：创建新客户帐户

- email （必填）：客户的电子邮件地址 - businessName （必填）：客户的企业名称 - contactName （可选）：主要联系人姓名 - phone （可选）：联系电话 - subscriptionTier （可选）：初学者、专业人士或企业

• 启用门户访问：为客户启用门户访问

- customerEmail （必填）：客户的电子邮件地址 - sendWelcomeEmail （可选）：发送欢迎电子邮件（默认值：true）

• 重置客户密码：重置客户密码

- customerEmail （必填）：客户的电子邮件地址 - sendEmail （可选）：发送密码重置电子邮件（默认值：true）

代理管理

• 地图代理：将AI代理映射到客户

- customerEmail （必填）：客户的电子邮件地址 - agentId （必填）：来自AI平台的代理ID - platform （必填）：复述、vapi、elevenlabs或高水平 - profitMultiplier （可选）：利润倍数1.0-10.0（默认值：1.5） - agentName （可选）：代理的自定义名称

• 更新代理：更新代理配置

- customerEmail （必填）：客户的电子邮件地址 - agentId （必填）：要更新的代理ID - profitMultiplier （可选）：新的利润乘数 - agentName （可选）：新代理名称 - isActive （可选）：启用/禁用代理

• 取消映射代理：从客户中删除代理映射

- customerEmail （必填）：客户的电子邮件地址 - agentId （必需）：要取消映射的代理ID

💡 使用示例

在克劳德桌面

配置后，您可以在Claude Desktop中使用自然语言命令：

"Create a new customer with email john@example.com and business name 'John's Restaurant'"

"Map a Retell agent with ID 'agent_123' to customer john@example.com with a 2.0 profit multiplier"

"Enable portal access for customer john@example.com and send them a welcome email"

"Check the health status of the Knotie AI Pro API"

命令行测试

直接测试服务器：

# Test the server
npm run dev

# Or if installed globally
knotie-ai-mcp

🔒 安全

• 本地配置：API密钥存储在本地，从不传输给第三方
• 安全通信：所有API调用都使用具有正确身份验证的HTTPS
• 合作伙伴验证：每个请求都包括合作伙伴电子邮件验证
• 无数据存储：MCP服务器不存储任何客户或代理数据

🐛 故障排除

服务器未显示在Claude桌面中

1. 检查你的 claude_desktop_config.json 语法
2. 确保服务器的路径正确
3. 完全重新启动克劳德桌面
4. 查看克劳德的日志： ~/Library/Logs/Claude/mcp*.log

配置错误

1. 验证您的API密钥是否正确
2. 确保您的合作伙伴电子邮件与您的帐户匹配
3. 检查配置文件是否位于支持的位置
4. 验证配置文件中的JSON语法

API连接问题

重要提示： MCP服务器连接到 分析服务，而不是Knotie AI Pro的主要网站。

正确的基本URL：

• 生产： https://analytics.knotie-ai.pro
• 发展： http://localhost:8000 （如果在本地运行分析服务）

常见问题：

1. 404未找到： 使用错误的基本URL（应该是analytics.knotie-ai.pro，而不是knotie ai.pro）
2. 连接被拒绝： 分析服务可能已关闭或URL不正确
3. 401未经授权： API密钥或合作伙伴电子邮件无效
4. 403禁止： 有效凭据但权限不足

调试步骤：

1. 测试您的互联网连接
2. 验证基本URL是否指向分析服务
3. 检查您的API密钥是否具有必要的权限
4. 确保您的合作伙伴帐户处于活动状态
5. 尝试手动连接到运行状况终结点：

   curl -H "X-API-Key: your-api-key" \
        -H "X-Partner-Email: your-email@example.com" \
        https://analytics.knotie-ai.pro/health

📚 文档

• Knotie AI Pro API文档
• 模型上下文协议规范
• Claude桌面设置指南

🤝 贡献

欢迎投稿！请随时提交拉取请求。

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

🆘 支持

• Knotie AI Pro支持
• MCP社区

______________________________________________________________________

由以下材料制成❤️ Knotie AI Pro团队