mcp受体
只读 主控程序 服务器 达克特尔 联系中心REST API v6。为任何兼容MCP的LLM客户端（Claude、Cursor等）提供对工单、电话、电子邮件、聊天、联系人、CRM记录、活动和实时代理状态的完全读取权限。
为什么
联络中心每天产生数千次互动——通过多个渠道进行电话、电子邮件和聊天。原始数据都在Daktela中，但从中提取见解需要手动审查或自定义报告。此服务器将Daktela连接到LLM，让您运行手动无法完成的分析：
电子邮件质量审核 --“分析过去72小时内的所有电子邮件。标记任何与负面客户情绪、客户选择竞争对手的交易失败或代理语气不专业的互动。对于每个标记的电子邮件，显示元数据、工单链接和问题描述。”
通话记录分析 --“查看上周的通话记录。确定客户升级、客服在产品知识方面遇到困难或做出承诺但未跟进的通话。用客服姓名、客户和建议的行动总结每个通话。”
销售渠道审查 --“查看S1发现和S2资格赛阶段的所有未结销售单。对于每个潜在客户，阅读最新的电子邮件线索，评估交易是否正在进行、停滞或有风险。按MRR排名，并建议本周需要注意的事项。”
LLM读取实际的对话内容——电子邮件正文、聊天消息、通话记录——并应用任何仪表板或过滤器都无法复制的判断。
工具
按域组织的40个只读工具：
| 类别 | 工具 |
|---|---|
| 门票 | list_tickets, count_tickets, get_ticket, get_ticket_detail, list_account_tickets, list_ticket_categories |
| 活动 | list_activities, get_activity |
| 呼叫 | list_calls, get_call, get_call_transcript, list_call_transcripts |
| 电子邮件 | list_emails, get_email |
| 消息传递 | list_web_chats, get_web_chat, list_sms_chats, get_sms, list_messenger_chats, get_messenger_chat, list_instagram_chats, get_instagram_chat, list_whatsapp_chats, get_whatsapp_chat, list_viber_chats, get_viber_chat |
| 联系人和CRM | list_contacts, get_contact, list_accounts, get_account, list_crm_records |
| 活动 | list_campaign_records, list_campaign_types |
| 参考数据 | list_queues, list_users, list_groups, list_pauses, list_statuses, list_templates |
| 实时 | list_realtime_sessions |
所有列表工具都支持分页(skip, take)、排序和上下文过滤器（阶段、优先级、日期范围、用户、队列等）。服务器包括详细 instructions 元数据，教导LLM如何使用过滤器、解析实体名称以及导航票证、联系人和帐户之间的关系。
入门
先决条件
- Python 3.12+
- 具有API访问权限的用户帐户的Daktela实例
- 紫外线 （推荐）或pip
安装
git clone https://github.com/hajekd/mcp-daktela.git
cd mcp-daktela
uv venv && uv pip install -e ".[dev]"使用Claude Desktop在本地运行
设置您的Daktela凭据，并将Claude Desktop指向服务器：
{
"mcpServers": {
"daktela": {
"command": "python",
"args": ["-m", "mcp_daktela"],
"env": {
"DAKTELA_URL": "https://your-instance.daktela.com",
"DAKTELA_USERNAME": "your-username",
"DAKTELA_PASSWORD": "your-password"
}
}
}
}就是这样。服务器使用与登录时相同的凭据对Daktela实例进行身份验证。您还可以使用 DAKTELA_ACCESS_TOKEN 而不是用户名/密码，如果你有一个静态的API令牌。
部署为HTTP服务器
对于共享或远程部署（例如Cloud Run），服务器以流式http模式运行，其中每个客户端通过http标头传递凭据：
gcloud run deploy mcp-daktela \
--source . \
--region europe-west1 \
--allow-unauthenticated \
--memory 1Gi该服务器还包括一个内置的OAuth 2.0提供程序，用作Claude.ai上的远程MCP服务器。
建筑
src/mcp_daktela/
├── server.py MCP tool definitions (40 tools)
├── formatting.py Format API records into readable markdown
├── client.py Async HTTP client for Daktela REST API
├── filters.py Build query parameters (filter/sort/pagination)
├── oauth.py OAuth 2.0 provider for Claude.ai remote MCP
├── auth.py Per-request credential middleware
├── config.py Credential resolution (ContextVar → env vars)
├── cache.py In-process TTL cache for reference data
├── logging_middleware.py Structured JSON logging for tool calls
└── __main__.py Entry point配置
| 环境变量 | 默认值 | 描述 |
|---|---|---|
DAKTELA_URL | -- | dakfabric实例URL |
DAKTELA_USERNAME | -- | dakcob用户名 |
DAKTELA_PASSWORD | -- | 达克布密码 |
DAKTELA_ACCESS_TOKEN | - | 静态API令牌（可替代用户名/密码） |
MCP_TRANSPORT | stdio | 运输： stdio 或 streamable-http |
PORT | 8080 | HTTP端口（可流式传输HTTP模式） |
CACHE_ENABLED | true | 启用参考数据缓存 |
CACHE_TTL_SECONDS | 3600 | 缓存TTL（秒） |
发展
# Unit tests (333 tests, ~1s)
.venv/bin/python -m pytest
# Lint
.venv/bin/python -m ruff check src/ tests/集成测试通过部署的服务器对实时Daktela实例运行每个工具：
.venv/bin/python scripts/integration_test.py \
--url https://your-instance.daktela.com \
--username your-user \
--password your-password许可证
麻省理工学院