QuiQSol

@quiqsol/mcp

将 QuiQSol 连接到 Claude、ChatGPT、Cursor 和任何 AI Agent。

此软件包提供两种功能：

• quiqsol mcp：通过 stdio 运行的本地 Model Context Protocol 服务，适用于会启动命令的应用（Claude Desktop、Claude Code、Cursor、Windsurf、VS Code）。
• quiqsol：供终端、脚本和 Agent 使用的命令行工具，输出为 JSON。

两者都运行在 QuiQSol 远程 MCP 服务 https://api.quiqsol.com/mcp 上。工具、权限和安全规则都由服务端管理，因此此软件包体积小、零依赖，新增工具时也无需更新。

采用 MIT 许可证。

Agent 能做什么

产品	读取	操作
CRM	搜索；列出和获取潜在客户、联系人、公司、交易、备注、任务；查看销售管道	创建和更新潜在客户、联系人、公司和交易；移动交易阶段；添加备注；创建和完成任务
Help Desk	列出和读取工单及其完整对话	回复（先预览）、添加内部备注、更改状态
Inbox	列出 WhatsApp、网站聊天和社交平台上的对话；读取消息	在 WhatsApp 24 小时窗口内回复（先预览）
Invoices	列出和读取发票及总额	创建发票草稿；发送（先预览）
Projects	列出项目和任务	创建和更新任务
Forms	列出表单和提交记录
Analytics	业务概览、销售、Help Desk 和发票摘要

安全模型

• 限定范围的访问。 每个密钥和连接都带有明确的范围（crm:read、crm:write、helpdesk:read、helpdesk:write、inbox:read、inbox:send、invoices:read、invoices:write、invoices:send、projects:read、projects:write、forms:read、analytics:read）。Agent 只能看到其范围允许使用的工具。
• 遵循你自己的权限。 Agent 会以创建密钥或批准连接的用户身份，并在该用户的角色权限范围内执行操作。它绝不会执行超出该用户在应用中权限的操作。
• 未经批准，任何内容都不会发送给客户。 工单回复、收件箱回复和发票发送都会先返回预览。只有再次调用并传入 confirm: true 后才会发送；Agent 收到的指示是，只有在你批准后才这样做。
• 不可信内容会明确标记。 每个结果都会作为工作区数据封装，客户撰写的文本会标记为数据，而不是指令。
• 输出中不含机密信息。 服务端会从每个结果中剥除令牌、哈希值和密钥。
• 可撤销并可审计。 在 Settings > Developer Platform 中可撤销任何密钥或连接。每次调用都会记录在其中的 API 活动日志中。

获取密钥

在 QuiQSol 中打开 Settings > Developer Platform > AI agents，选择 Create AI agent key，选择范围并复制密钥（仅显示一次）。

Claude 和 ChatGPT 无需密钥：添加 https://api.quiqsol.com/mcp 作为连接器，然后使用 OAuth 登录。请参阅设置指南。

与 Claude Desktop、Cursor 或任何 stdio MCP 客户端搭配使用

{
  "mcpServers": {
    "quiqsol": {
      "command": "npx",
      "args": ["-y", "@quiqsol/mcp", "mcp"],
      "env": { "QUIQSOL_API_KEY": "aur_live_..." }
    }
  }
}

Claude Desktop：Settings > Developer > Edit Config。Cursor：~/.cursor/mcp.json 或 Settings > MCP。

支持远程服务的客户端可以跳过此软件包，直接连接服务：

{
  "mcpServers": {
    "quiqsol": {
      "url": "https://api.quiqsol.com/mcp",
      "headers": { "Authorization": "Bearer aur_live_..." }
    }
  }
}

Claude Code：

claude mcp add --transport http quiqsol https://api.quiqsol.com/mcp

使用 CLI

npm install -g @quiqsol/mcp
quiqsol login
quiqsol whoami

quiqsol leads list --status NEW --limit 10
quiqsol leads create --first-name Ada --last-name Obi --email [email protected] --source WEBSITE
quiqsol deals pipeline
quiqsol deals move 66f0c2aa66f0c2aa66f0c2aa "Proposal sent"
quiqsol tickets list --status OPEN --mine
quiqsol tickets reply 66f0c2aa66f0c2aa66f0c2aa --body "Your refund was processed today."
quiqsol inbox list --channel whatsapp --unread
quiqsol invoices create --contact-id 66f0c2aa66f0c2aa66f0c2aa --item "Website design:1:450000" --due-date 2026-11-30
quiqsol invoices send 66f0c2aa66f0c2aa66f0c2aa
quiqsol analytics overview --days 30

按名称调用任意工具：

quiqsol tools
quiqsol call crm_list_deals '{"stage":"Negotiation","limit":5}'

输出为 stdout 上的 JSON（终端中为易读格式，通过管道传输时为紧凑格式）。会联系客户的命令会先显示预览并在发送前征求确认；在脚本中，它们会打印预览并以代码 3 退出，除非传入 --yes。

退出代码	含义
0	完成
1	错误（消息输出到 stderr）
2	用法错误
3	仅预览，未发送任何内容

配置：QUIQSOL_API_KEY 和 QUIQSOL_API_URL 会覆盖 ~/.config/quiqsol/config.json 中保存的登录信息（文件仅授予所有者权限）。

在代码中使用

const { QuiqsolClient } = require('@quiqsol/mcp');

const quiqsol = new QuiqsolClient({ apiKey: process.env.QUIQSOL_API_KEY });
const { data } = await quiqsol.callTool('crm_list_leads', { status: 'NEW', limit: 5 });

更倾向于使用纯 HTTP？通过 https://api.quiqsol.com/public/v1/agent 也可以使用相同的工具（GET /tools、POST /tools/{name}）。

要求

Node.js 18 或更高版本。

许可证

MIT。QuiQSol 平台本身是一项商业服务；此连接器采用开源许可，因此你可以确切了解在你的机器上运行的内容。