使用说明

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):

创建配置目录：
```
mkdir -p ~/.knotie
```

创建配置文件：

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

添加您的凭据：

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

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

如果克隆了存储库：

复制示例配置：

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

编辑配置：

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

更新您的凭据：

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

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

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

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

获取您的API凭据

登录您的Knotie AI Pro合作伙伴仪表板
导航到“设置”→ API密钥
创建新的API密钥
将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桌面中

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

配置错误

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

API连接问题

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

正确的基本URL：

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

常见问题：

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

调试步骤：

测试您的互联网连接
验证基本URL是否指向分析服务
检查您的API密钥是否具有必要的权限
确保您的合作伙伴帐户处于活动状态

尝试手动连接到运行状况终结点：

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

📚 文档

🤝 贡献

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

📄 许可证

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

🆘 支持

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

使用说明

Knotie AI Pro MCP服务器

🚀 特性

📋 先决条件

🚀 快速开始

NPM用户（推荐）

开发者（来源）

🛠️ 安装

开发者（来源）

� 快速开始

NPM用户（推荐）

开发者（来源）

🛠️ 安装

选项1:NPM安装（推荐）

全局安装故障排除

选项2：来源

⚙️ 配置

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

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

选项A:NPM安装

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

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

获取您的API凭据

🔧 Claude桌面设置

1.安装克劳德桌面

2.配置克劳德桌面

3.添加Knotie AI Pro服务器

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

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

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

4.重新启动克劳德桌面

🎯 可用工具

系统工具

客户管理

代理管理

💡 使用示例

在克劳德桌面

命令行测试

🔒 安全

🐛 故障排除

服务器未显示在Claude桌面中

配置错误

API连接问题

📚 文档

🤝 贡献

📄 许可证

🆘 支持

相关 MCP

邮件营销管理服务器

发票管理服务

Housecall Pro MCP服务

Cisco CX Cloud API自然语言访问服务

营销自动化协议服务器

AI旅行规划助手