DEVELOPERS
AI와 자동화를 위한 개방형 플랫폼
두 가지 연결 방식: REST API로 고객·딜·작업·지식 베이스를 자체 워크플로우에 연동하고, MCP로 Claude·ChatGPT·Cursor에서 안전하게 CRM을 읽고 씁니다. 모든 엔드포인트는 프로덕션에서 운영 중입니다.
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 내 승인 필요) |
| 🧠 자연어 질의 | 허용된 데이터 범위 내 무엇이든 질문 |
3단계로 연결
STEP 1 · 토큰 발급
SiliMind → 설정 → MCP Access → Generate에서 MCP 토큰을 발급합니다.
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?”
보안 설계
🔒 토큰별 권한readonly / readwrite 두 가지 범위
🔒 테넌트 격리당신의 AI는 당신의 데이터만 봅니다
🔒 레이트 리밋 + 전체 감사 로그모든 호출 추적 가능
🔒 쓰기에는 승인 필요AI가 제안하고, 당신이 SiliMind 안에서 승인
API
REST API
모든 엔드포인트는 Bearer 토큰 인증을 사용하며, 핵심 리소스 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 — 토큰 만료 또는 무효 - 권한 없음 —
403 - 찾을 수 없음 —
404 - 검증 오류 —
422, 필드 상세 포함 - 레이트 리밋 —
429
페이지네이션
목록 엔드포인트는 page 및 page_size 쿼리 파라미터를 사용합니다(기본 20, 최대 100).
레이트 리밋
- 토큰 단위 레이트 리밋 적용
- 초과 시 Retry-After 헤더와 함께 429 반환
지원
문서: https://www.silimind.net · MCP 통합: github.com/Leonchen3352/silimind-mcp · 문의: micheal@silimind.net