AI导哈

CRM集成AI助手服务

Moxie MCP Server是一个连接AI助手（如Claude）到Moxie CRM工作空间的协议服务器，支持通过自然语言管理客户、发票、项目、票据等。

  • by theloniuser
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 theloniuser/moxie-mcp-server

使用说明

Moxie MCP服务器

一个MCP（模型上下文协议）服务器，将Claude等人工智能助手连接到您的 莫西CRM 工作空间。通过自然语言管理客户、发票、项目、门票等。

它能做什么

类别 工具
客户 列出、搜索、创建客户端
联系人 为客户搜索、创建联系人
项目 搜索、创建带有费用表的项目
任务 创建包含子任务、优先级和指定人员的任务
发票 搜索应付发票、创建发票、申请付款
开支 创建支出记录
时间追踪 记录项目/任务的时间条目
门票 列出、创建和评论支持票
机会 创建渠道机会，列出阶段
日历 创建或更新日历事件
模板 列出电子邮件模板、发票模板、表单
文件 将文件从URL附加到任何实体
交付物 批准可交付成果/任务

共30个工具 涵盖整个莫西公共API。

先决条件

  • Node.js 18+
  • 启用API访问的Moxie工作区
  • 您的Moxie API密钥和基础URL

获取API凭据

  1. 登录您的Moxie工作区
  2. 首选 工作区设置>已连接的应用程序>集成
  3. 复制您的 API密钥
  4. 注意你的 基本URL （例如。， https://pod00.withmoxie.dev)

安装

git clone https://github.com/theloniuser/moxie-mcp-server.git
cd moxie-mcp-server
npm install

配置

克劳德桌面/克劳德代码

添加到您的Claude配置(~/.claude.json 或克劳德桌面设置）：

{
  "mcpServers": {
    "moxie": {
      "command": "node",
      "args": ["/path/to/moxie-mcp-server/moxie-mcp-server.js"],
      "env": {
        "MOXIE_BASE_URL": "https://pod00.withmoxie.dev",
        "MOXIE_API_KEY": "your-api-key-here"
      }
    }
  }
}

环境变量

变量 必填 描述
MOXIE_BASE_URL 是 您的Moxie工作区URL（例如。， https://pod00.withmoxie.dev)
MOXIE_API_KEY 是 工作区设置中的API键

您还可以使用 .env 用于基于Docker的设置的文件。

用法示例

配置后，问Claude以下问题：

  • “搜索所有蓝带客户”
  • “为Acme Corp创建包含2行项目的发票”
  • “登录网站重新设计项目3小时”
  • “为客户支持创建高优先级票证”
  • “此客户的哪些发票未结清？”
  • “为项目启动会议添加日历事件”

独立运行

# Set environment variables
export MOXIE_BASE_URL="https://pod00.withmoxie.dev"
export MOXIE_API_KEY="your-api-key"

# Run the server
npm start

已知限制

  • 发票搜索仅返回未付/应付发票 -这是Moxie API的限制，而不是服务器的限制。没有用于检索已付款/已存档发票的公共API终结点。
  • 客户端名称过滤器要求创建操作完全匹配（搜索是模糊的）。

许可证

麻省理工学院

相关 MCP