Pestprocrm MCP

🚀 PestProCRM MCP 服務器

藉助模型上下文協議（MCP），將 Claude 連接到你的 PestPro CRM 賬戶。通過自然對話，你可以管理客戶、安排預約、發送短信、跟蹤付款並生成報告。

🚀 快速開始

連接Claude.ai（推薦）

1. 訪問 claude.ai。
2. 打開設置 → 集成（或點擊 MCP 圖標）。
3. 點擊添加自定義集成。
4. 輸入服務器 URL：https://www.pestprocrm.com/api/mcp。
5. 點擊連接，你將被重定向到使用 PestProCRM 賬戶登錄。
6. 授權 Claude 訪問你的數據。
7. 開始聊天！

連接Claude桌面版

1. 登錄 PestProCRM，進入設置 → API 密鑰。
2. 點擊生成新密鑰並複製密鑰（以 pp_live_ 開頭）。
3. 克隆此倉庫並構建：

   git clone https://github.com/yourusername/pestprocrm-mcp.git
   cd pestprocrm-mcp
   npm install && npm run build
   

4. 添加到你的 Claude 桌面版配置中：
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

   {
     "mcpServers": {
       "pestpro": {
         "command": "node",
         "args": ["/absolute/path/to/pestprocrm-mcp/dist/index.js"],
         "env": {
           "PESTPRO_API_URL": "https://www.pestprocrm.com",
           "PESTPRO_API_KEY": "pp_live_your-key-here"
         }
       }
     }
   }
   

5. 重啟 Claude 桌面版。

連接Claude代碼版

在你的項目的 .mcp.json 中添加以下內容：

{
  "mcpServers": {
    "pestpro": {
      "command": "node",
      "args": ["/absolute/path/to/pestprocrm-mcp/dist/index.js"],
      "env": {
        "PESTPRO_API_URL": "https://www.pestprocrm.com",
        "PESTPRO_API_KEY": "pp_live_your-key-here"
      }
    }
  }
}

✨ 主要特性

可用工具

客戶管理

日程安排

短信消息

支付管理

報告生成

只讀資源

💻 使用示例

基礎用法

1. 查找客戶並檢查餘額

"查找我的客戶 John Smith 並告訴我他是否有未支付的款項"

Claude 將搜索你的客戶，調出 John 的詳細信息，並檢查他的支付狀態，所有操作都在一個回覆中完成。

2. 安排預約

"為 Jane Doe 在下週二下午 2 點安排一次德國蟑螂處理服務"

Claude 將查找客戶，檢查你的可用時間，並安排預約。

3. 通過短信發送付款提醒

"哪些客戶欠我錢？給逾期的客戶發送友好的付款提醒，並附上他們的支付鏈接"

Claude 將檢查未支付款項，生成支付鏈接，並向每個逾期客戶發送短信。

4. 獲取每日日程簡報

"我明天的日程安排是怎樣的？"

Claude 將顯示當天的所有預約，包括客戶姓名、服務類型、地址和任何空閒時間段。

5. 記錄已完成的服務

"我剛剛完成了 Mary Johnson 家的服務。將其標記為已完成 — 一般害蟲處理，室內和室外，無問題。她用現金支付了 75 美元"

Claude 將根據你的備註將訪問標記為已完成，並記錄現金支付。

6. 月度業務回顧

"給我上個月與前一個月相比的收入報告。我新增了多少客戶？"

Claude 將提取收入數據和客戶指標，為你提供業務摘要。

🔧 技術細節

安全機制

• OAuth（Claude.ai）：使用行業標準的 OAuth 2.0 與 PKCE。無需管理 API 密鑰，只需通過瀏覽器登錄。
• API 密鑰（桌面版/代碼版）：密鑰存儲在你的 Claude 配置中。絕不會與第三方共享。
• 所有 API 調用都經過身份驗證，並且僅限於你的賬戶範圍。
• 可以隨時從設置 → API 密鑰中撤銷 API 密鑰。

故障排除

📚 詳細文檔

相關鏈接

• PestPro CRM：https://www.pestprocrm.com
• 文檔：https://www.pestprocrm.com/docs
• MCP 文檔：https://www.pestprocrm.com/docs/mcp
• MCP 協議：https://modelcontextprotocol.io

📄 許可證

本項目採用 MIT 許可證。