MCP (Model Context Protocol) — это стандарт, который позволяет AI-агентам напрямую обращаться к внешним сервисам. Подключив DataForce по MCP, ваш агент сможет работать с данными платформы напрямую — без ручных выгрузок и копипаста: строить нейро-отчёты, управлять семантическим ядром, импортировать и экспортировать данные.
Инструкция универсальна и подходит для любого клиента с поддержкой MCP — Claude Desktop, Cursor, VS Code + Cline, Qwen Code и других.
У DataForce два публичных MCP-сервера. Подключите тот, к которому у вас есть доступ, — или оба сразу:
| Сервер | URL | Что внутри |
|---|---|---|
| DataForce ADS | https://direct.dataforce.io/api/mcp |
Расширенные отчёты (report.*, report.dictionary.*) + управление семантикой |
| DataForce AI | https://ai.dataforce.io/api/mcp |
Нейро-отчёты (report.neuro) + управление семантикой |
Токен доступа выдаёт поддержка DataForce. Это ваш ключ к API — он привязан к аккаунту и определяет, к каким данным у агента будет доступ.
Authorization: Bearer ВАШ_ТОКЕН
Править конфигурационные файлы вручную не нужно. Современные AI-агенты умеют настраивать MCP-сервер самостоятельно — вы просто даёте им промпт ниже, и агент сам вписывает сервер в свой конфиг.
Промпт для агента — скопируйте и отправьте его своему агенту, подставив свои токены вместо ТОКЕН:
Настрой MCP-серверы DataForce. Транспорт строго streamable HTTP (НЕ SSE), токен передавай в заголовке Authorization: Bearer.
DataForce Direct (ADS DATAFORCE):
URL: https://direct.dataforce.io/api/mcp
Authorization: Bearer ТОКЕН
DataForce AI:
URL: https://ai.dataforce.io/api/mcp
Authorization: Bearer ТОКЕН
Подключи тот сервер, к которому у меня есть доступ (или оба).
После настройки проверь подключение — запроси ресурс spaces://active и покажи список доступных пространств.
Агент сам впишет серверы в свой конфиг, подставит токены и подключится. У успешного подключения в интерфейсе агента появится статус Connected, а инструменты DataForce станут доступны с префиксом mcp__.
DataForce работает по streamable HTTP, а не SSE. Если агент не подключается — проверьте transport. Например в Qwen Code для этого нужен ключ
httpUrl(неurl); в остальных клиентах —type: "http". Признак успеха: статус Connected и инструменты с префиксомmcp__.
Если хотите настроить MCP вручную или ваш агент не поддерживает авто-настройку, используйте один из примеров ниже. Подставьте свои токены вместо ТОКЕН; сервер, к которому нет доступа, можно удалить.
claude_desktop_config.json{
"mcpServers": {
"dataforce-direct": {
"type": "http",
"url": "https://direct.dataforce.io/api/mcp",
"headers": {
"Authorization": "Bearer ТОКЕН"
}
},
"dataforce-ai": {
"type": "http",
"url": "https://ai.dataforce.io/api/mcp",
"headers": {
"Authorization": "Bearer ТОКЕН"
}
}
}
}
.cursor/mcp.json{
"mcpServers": {
"dataforce-direct": {
"type": "http",
"url": "https://direct.dataforce.io/api/mcp",
"headers": {
"Authorization": "Bearer ТОКЕН"
}
},
"dataforce-ai": {
"type": "http",
"url": "https://ai.dataforce.io/api/mcp",
"headers": {
"Authorization": "Bearer ТОКЕН"
}
}
}
}
cline_mcp_settings.json{
"mcpServers": {
"dataforce-direct": {
"type": "http",
"url": "https://direct.dataforce.io/api/mcp",
"headers": {
"Authorization": "Bearer ТОКЕН"
}
},
"dataforce-ai": {
"type": "http",
"url": "https://ai.dataforce.io/api/mcp",
"headers": {
"Authorization": "Bearer ТОКЕН"
}
}
}
}
.qwen/settings.jsonВажно: используйте ключ
httpUrl, а неurl. СurlQwen Code пытается подключиться через SSE — и сервер отключается.
{
"mcpServers": {
"dataforce-direct": {
"httpUrl": "https://direct.dataforce.io/api/mcp",
"headers": {
"Authorization": "Bearer ТОКЕН"
}
},
"dataforce-ai": {
"httpUrl": "https://ai.dataforce.io/api/mcp",
"headers": {
"Authorization": "Bearer ТОКЕН"
}
}
}
}
Когда MCP подключён, не обязательно читать документацию по каждому инструменту — просто спросите агента. Он сам видит описания всех инструментов DataForce и подскажет, что можно сделать.
Примеры первых запросов:
Агент сам вызовет нужные инструменты, сгруппирует данные и объяснит результат. Дальше можно автоматизировать рутину — сводки по видимости, аудит семантики, импорт и экспорт данных.