Knotie AI Pro MCP Server

Name: Knotie AI Pro MCP Server
Author: avijeett007

本地服务

github.com/avijeett007AI 与智能体273 周前更新

代码仓库

关于 Knotie AI Pro MCP Server

Knotie AI Pro MCP Server 面向 Knotie AI Pro 合作伙伴，可通过 MCP 客户端管理客户账户及其 AI 语音 Agent。它还支持将 Agent 关联到多个平台，并由本地配置保存 API 密钥。

主要功能

01创建客户账户并管理门户访问
02重置客户密码
03关联和配置客户 AI Agent
04支持 Retell、VAPI、ElevenLabs、GoHighLevel
05本地保存 API 密钥

适用场景

01为新客户创建账户并启用门户
02将语音 Agent 关联到客户
03更新或移除客户的 Agent 关联
04检查 API 健康状态

MCP 相关

该服务向 MCP 客户端提供客户管理、Agent 管理及系统健康检查工具，使用 Knotie AI Pro API 凭据与平台交互。

#knotie-ai #mcp #ai-agent-management

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令npx -y knotie-ai-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmknotie-ai-mcpstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Knotie AI Pro MCP 服务

一个模型上下文协议（MCP）服务，可让 Claude Desktop 等 AI Agent 与 Knotie AI Pro 平台交互，实现客户管理和语音 AI Agent 管理自动化。

🚀 功能

客户管理：创建客户、启用门户访问权限、重置密码
Agent 管理：将 AI Agent 映射到客户、更新配置、管理利润倍数
多平台支持：适用于 Retell、VAPI、ElevenLabs、GoHighLevel
安全的本地配置：API 密钥存储在本地，绝不会传输给第三方
Claude Desktop 集成：与 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":"[email protected]","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":"[email protected]","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":"[email protected]","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 的 prefix 标志（推荐）

# 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": "[email protected]",
        "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": "[email protected]",
  "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": "[email protected]",
  "baseUrl": "https://analytics.knotie-ai.pro"
}

配置文件位置（按优先级排序）

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

./knotie-config.json（当前目录）
~/.knotie/config.json（主目录）- 推荐用于 NPM 安装
./config/knotie-config.json（相对于安装目录）- 用于从源代码安装

获取 API 凭据

登录 Knotie AI Pro 合作伙伴控制面板
转到 Settings → API Keys
创建新的 API 密钥
将 API 密钥和合作伙伴邮箱复制到配置文件中

🔧 Claude Desktop 设置

1. 安装 Claude Desktop

如果尚未安装，请下载并安装 Claude Desktop。

2. 配置 Claude Desktop

编辑 Claude Desktop 配置文件：

macOS/Linux：

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

Windows：

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": "[email protected]",
        "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

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

🎯 可用工具

系统工具

get-capabilities：获取系统能力和可用功能
get-health：检查 API 健康状态

客户管理

create-customer：创建新的客户账户
- email（必填）：客户的电子邮箱地址
- businessName（必填）：客户的企业名称
- contactName（可选）：主要联系人姓名
- phone（可选）：联系电话
- subscriptionTier（可选）：starter、professional 或 enterprise
enable-portal-access：为客户启用门户访问权限
- customerEmail（必填）：客户的电子邮箱地址
- sendWelcomeEmail（可选）：发送欢迎邮件（默认：true）
reset-customer-password：重置客户密码
- customerEmail（必填）：客户的电子邮箱地址
- sendEmail（可选）：发送密码重置邮件（默认：true）

Agent 管理

map-agent：将 AI Agent 映射到客户
- customerEmail（必填）：客户的电子邮箱地址
- agentId（必填）：AI 平台提供的 Agent ID
- platform（必填）：retell、vapi、elevenlabs 或 gohighlevel
- profitMultiplier（可选）：利润乘数，范围为 1.0-10.0（默认：1.5）
- agentName（可选）：Agent 的自定义名称
update-agent：更新 Agent 配置
- customerEmail（必填）：客户的电子邮箱地址
- agentId（必填）：要更新的 Agent ID
- profitMultiplier（可选）：新的利润乘数
- agentName（可选）：新的 Agent 名称
- isActive（可选）：启用/停用 Agent
unmap-agent：移除客户的 Agent 映射
- customerEmail（必填）：客户的电子邮箱地址
- agentId（必填）：要取消映射的 Agent ID

💡 使用示例

在 Claude Desktop 中

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

"Create a new customer with email [email protected] and business name 'John's Restaurant'"

"Map a Retell agent with ID 'agent_123' to customer [email protected] with a 2.0 profit multiplier"

"Enable portal access for customer [email protected] 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 服务不会存储任何客户或 Agent 数据

🐛 故障排除

Claude Desktop 中未显示服务

检查 claude_desktop_config.json 语法
确保服务路径正确
完全重启 Claude Desktop
检查 Claude 日志：~/Library/Logs/Claude/mcp*.log

配置错误

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

API 连接问题

**重要提示：**MCP 服务连接的是 Analytics Service，而不是 Knotie AI Pro 主网站。

正确的基础 URL：

生产环境：https://analytics.knotie-ai.pro
开发环境：http://localhost:8000（如果在本地运行 analytics service）

常见问题：

**404 Not Found：**使用了错误的基础 URL（应为 analytics.knotie-ai.pro，而不是 knotie-ai.pro）
**Connection Refused：**Analytics Service 可能已宕机，或 URL 不正确
**401 Unauthorized：**API 密钥或合作伙伴电子邮箱无效
**403 Forbidden：**凭据有效，但权限不足

调试步骤：

测试互联网连接
确认基础 URL 指向 Analytics Service
检查 API 密钥是否具有必要的权限
确保合作伙伴账户处于启用状态

尝试手动连接到健康检查端点：

curl -H "X-API-Key: your-api-key" \
     -H "X-Partner-Email: [email protected]" \
     https://analytics.knotie-ai.pro/health

📚 文档

🤝 贡献

欢迎贡献！请随时提交 Pull Request。

📄 许可证

MIT 许可证 - 详情请参阅 LICENSE 文件。

🆘 支持

由 Knotie AI Pro 团队用 ❤️ 打造

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

Knotie AI Pro MCP Server

关于 Knotie AI Pro MCP Server

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

Knotie AI Pro MCP 服务

🚀 功能

📋 前提条件

🚀 快速开始

适用于 NPM 用户（推荐）

适用于开发者（从源代码安装）

🛠️ 安装

适用于开发者（从源代码安装）

� 快速开始

适用于 NPM 用户（推荐）

适用于开发者（从源代码安装）

🛠️ 安装

选项 1：通过 NPM 安装（推荐）

全局安装故障排除

选项 2：从源代码安装

⚙️ 配置

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

方法 2：配置文件（替代方案）

选项 A：NPM 安装

方法 2：从源代码安装（克隆仓库）

配置文件位置（按优先级排序）

获取 API 凭据

🔧 Claude Desktop 设置

1. 安装 Claude Desktop

2. 配置 Claude Desktop

3. 添加 Knotie AI Pro 服务

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

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

选项 C：从源代码安装并使用配置文件

4. 重启 Claude Desktop

🎯 可用工具

系统工具

客户管理

Agent 管理

💡 使用示例

在 Claude Desktop 中

命令行测试

🔒 安全性

🐛 故障排除

Claude Desktop 中未显示服务

配置错误

API 连接问题

📚 文档

🤝 贡献

📄 许可证

🆘 支持

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？