MCP
把 AI 助手连上你的 CRM
SiliMind 支持 MCP(Model Context Protocol)——AI 助手使用外部工具的标准协议。你的 AI 助手可以直接读取(并在你批准后写入)你的 SiliMind CRM。
能连什么
🤖
Claude Desktop
直接问 Claude 你的商机、客户、任务
💬
ChatGPT
通过自定义 GPT 查询你的销售管线
⚙️
Cursor / 任意 MCP 客户端
在 SiliMind 数据上构建你自己的 AI 工作流
你的 AI 能做什么
| 🔍 搜索客户 | “找出 Acme Corp 的所有联系人” |
| 📊 查商机 | “我跟进中的管线有哪些?” |
| 📅 看日程 | “我明天有什么安排?” |
| 📝 建任务 | “给 John 加一条跟进任务”(需你在 SiliMind 内批准) |
| 🧠 自然语言查询 | 关于你被授权数据的任何问题 |
三步接入
STEP 1 · 获取 token
SiliMind → 设置 → MCP Access → Generate,生成你的 MCP token。
STEP 2 · 添加到 Claude Desktop
把下面的配置加入 Claude Desktop 配置文件:
{
"mcpServers": {
"silimind": {
"command": "python",
"args": ["-m", "silimind_mcp.stdio_bridge"],
"env": {
"SILIMIND_URL": "https://agent.silimind.net",
"SILIMIND_TOKEN": "smcp_your_token"
}
}
}
} STEP 3 · 直接提问
“Hey Claude, what are my top deals this week?”
安全设计
🔒 每个 token 独立权限readonly / readwrite 两种粒度
🔒 租户隔离你的 AI 只能看到你的数据
🔒 限流 + 全量审计日志每次调用可追溯
🔒 写入需你批准AI 提议,你在 SiliMind 内确认
API
REST API
全部端点基于 Bearer token 认证,覆盖核心资源 CRUD、AI 建议与知识库语义检索。
Base URL: https://agent.silimind.net/api认证
POST /api/auth/login
Content-Type: application/json
{
"email": "you@company.com",
"password": "your_password"
} Response:
{
"accessToken": "eyJhbGciOiJIUzI1NiIs...",
"tokenType": "bearer",
"role": "sales"
} 后续所有请求携带:
Authorization: Bearer eyJhbG…s...
核心资源
客户 Contacts
| Method | Endpoint | Description |
|---|---|---|
| GET | /contacts | List contacts (paginated, searchable) |
| POST | /contacts | Create a contact |
| GET | /contacts/{id} | Get contact detail |
| PUT | /contacts/{id} | Update a contact |
| DELETE | /contacts/{id} | Delete a contact |
公司 Companies
| Method | Endpoint | Description |
|---|---|---|
| GET | /companies | List companies |
| POST | /companies | Create a company |
| GET | /companies/{id} | Get company detail |
| PUT | /companies/{id} | Update |
| DELETE | /companies/{id} | Delete |
商机 Deals
| Method | Endpoint | Description |
|---|---|---|
| GET | /deals | List deals |
| POST | /deals | Create a deal |
| GET | /deals/{id} | Get deal detail |
| PUT | /deals/{id} | Update deal (stage, amount, etc.) |
| DELETE | /deals/{id} | Delete |
任务 Tasks
| Method | Endpoint | Description |
|---|---|---|
| GET | /tasks | List tasks |
| POST | /tasks | Create a task |
| PUT | /tasks/{id} | Update (complete, reschedule) |
| DELETE | /tasks/{id} | Delete |
沟通记录 Interactions
| Method | Endpoint | Description |
|---|---|---|
| GET | /interactions | List interaction records |
| POST | /interactions | Log an interaction (call, email, meeting) |
拜访 Visits
| Method | Endpoint | Description |
|---|---|---|
| GET | /visits | List visits |
| POST | /visits | Schedule a visit |
示例 — 搜索客户
GET /api/contacts?q=acme&page=1&page_size=20
Authorization: Bearer <your-token> 示例 — 创建客户
POST /api/contacts
Content-Type: application/json
Authorization: Bearer <your-token>
{
"name": "John Smith",
"email": "john@acme.com",
"company": "Acme Corp",
"phone": "+86 138 0000 0000"
} 示例 — 查看跟进管线
GET /api/deals?stage=follow_up
Authorization: Bearer <your-token> AI 能力
AI 建议
GET /api/ai/suggestions
Authorization: Bearer <your-token> AI 对话(agent)
POST /api/agent-chat/{agent_id}/message
Content-Type: application/json
Authorization: Bearer <your-token>
{"content": "帮我总结这个客户最近的沟通"} 流式 SSE 响应。
知识库
| Method | Endpoint | Description |
|---|---|---|
| GET | /knowledge/docs | List documents |
| POST | /knowledge/docs/upload | Upload document (PDF/DOCX/MD) |
| POST | /knowledge/search | Semantic search |
示例 — 语义搜索
POST /api/knowledge/search
Content-Type: application/json
Authorization: Bearer <your-token>
{"query": "产品规格参数", "top_k": 5}
响应约定
- 成功 —
200 / 201(创建) - 认证失败 —
401 — token 过期或无效 - 无权限 —
403 - 不存在 —
404 - 参数校验失败 —
422,附字段详情 - 触发限流 —
429
分页
列表端点使用 page 与 page_size 查询参数(默认 20,最大 100)。
限流
- 按 token 维度限流
- 超限返回 429,并附 Retry-After 响应头
支持
文档:https://www.silimind.net · MCP 集成:github.com/Leonchen3352/silimind-mcp · 联系:micheal@silimind.net