MCP Folk

🚀 Folk CRM MCP 服務器

Folk CRM MCP 服務器是一個 MCP（模型上下文協議）服務器，它提供對 Folk CRM 功能的訪問，允許 AI 助手管理聯繫人、公司、筆記、提醒等。

🚀 快速開始

你可以通過以下兩種方式將該服務器添加到 Claude Code 中：

從註冊表添加（已發佈版本）

# 配置你的 Folk API 密鑰
mpak config set @nimblebraininc/folk api_key=your_api_key_here

# 添加到 Claude Code
claude mcp add folk -- mpak run @nimblebraininc/folk

本地開發環境添加

# 克隆並進入倉庫
git clone https://github.com/NimbleBrainInc/mcp-folk.git
cd mcp-folk

# 安裝依賴
uv sync

# 構建捆綁包
make pack

# 配置你的 API 密鑰
mpak config set @nimblebraininc/folk api_key=your_api_key_here

# 添加到 Claude Code（使用絕對路徑）
claude mcp add folk -- mpak run --local /path/to/mcp-folk/mcp-folk-0.1.0-darwin-arm64.mcpb

✨ 主要特性

• 智能搜索：以最少的令牌使用量按名稱查找人員和公司。
• 兩階段查找：快速搜索返回 ID，然後根據需要獲取完整詳細信息。
• 聯繫人管理：創建、更新和刪除人員與公司信息。
• 筆記與提醒：為聯繫人添加相關上下文信息。
• 交互記錄：跟蹤電子郵件、會議和電話記錄。
• 內置技能資源：提供 skill://folk/usage 資源，教導大語言模型（LLMs）正確的工具路由、ID 格式規則和情景處理模式。

📦 安裝指南

獲取你的 Folk API 密鑰

1. 登錄到你的 Folk 工作區。
2. 轉到 設置 > API。
3. 創建一個新的 API 密鑰。
4. 複製密鑰並使用 mpak config set 進行配置。

💻 使用示例

可用工具

搜索工具（優先使用）

詳情工具（查找之後使用）

瀏覽工具

分組與過濾工具

操作工具

筆記與提醒工具

實用工具

常見用例

• 查找聯繫人
  • "我的 CRM 中有沒有 Sarah Chen？"
  • "查找 Acme 公司的所有人員"
  • "John 的郵箱是什麼？"
• 會議後添加聯繫人
  • "添加今天會議中的 Mike Johnson，他是 Stripe 的項目經理"
  • "為 lisa@example.com 創建一個聯繫人"
• 記錄筆記
  • "給 Sarah 添加一條筆記：討論了第二季度的路線圖，她對企業計劃感興趣"
  • "我關於 Acme 交易的筆記有哪些？"
• 設置跟進提醒
  • "提醒我下週二跟進 John"
  • "設置一個提醒，兩週後與 Sarah 聯繫"
• 記錄交互信息
  • "記錄我今天和 Mike 通了電話"
  • "記錄我與 Acme 團隊的會議"
• 瀏覽聯繫人
  • "顯示我最近的聯繫人"
  • "列出我 CRM 中的所有公司"
• 查詢分組和管道
  • "顯示 '演示管理' 中狀態為 '跟進 1' 的潛在客戶"
  • "列出我的投資者組中的所有人員"
  • "查找我的客戶組中的活躍客戶"
  • "我在 Folk 中有哪些組？"

示例流程

用戶：“我剛和 Alex Rivera 一起喝咖啡，她對我們的 API 感興趣。提醒我下週給她發送文檔。”

AI：find_person("Alex Rivera")
→ {"found": true, "matches": [{"id": "abc123", "name": "Alex Rivera", "email": "alex@techco.io"}]}

AI：add_note("abc123", "Had coffee - interested in API, wants to see docs")
→ {"id": "note456", "added": true}

AI：log_interaction("abc123", "meeting", "2024-01-15T10:00:00Z")
→ {"id": "int789", "logged": true}

AI：set_reminder("abc123", "Send API docs to Alex", "2024-01-22T09:00:00Z")
→ {"id": "rem012", "set": true}

AI：“完成！我已經添加了關於你們咖啡聊天的筆記，記錄了會議，並設置了下週一給她發送 API 文檔的提醒。”

🔧 技術細節

開發命令

# 安裝開發依賴
uv sync --dev

# 運行測試
uv run pytest tests/ -v

# 格式化代碼
uv run ruff format .

# 代碼檢查
uv run ruff check .

# 類型檢查
uv run mypy src/

# 運行所有檢查
make check

# 構建測試捆綁包
make pack

API 參考

此服務器使用 Folk REST API。關鍵端點信息如下：

• 基礎 URL：https://api.folk.app/v1
• 認證方式：Bearer 令牌
• 有速率限制（詳見 Folk 文檔）

📄 許可證

本項目採用 MIT 許可證。