English Français العربية

io.github.theYahia/calltouch-mcp

السجل الرسمي مؤرشف البيانات وقواعدها

MCP server for Calltouch API — call tracking, call statistics. Token auth.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @theyahia/calltouch-mcp
Claude Code 
claude mcp add calltouch-mcp -e 'CALLTOUCH_TOKEN=<your calltouch_token>' -- npx -y @theyahia/calltouch-mcp@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "calltouch-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@theyahia/calltouch-mcp@1.0.1"
            ],
            "env": {
                "CALLTOUCH_TOKEN": "<your calltouch_token>"
            }
        }
    }
}

متغيرات البيئة

  • CALLTOUCH_TOKEN إلزامي سري API key for the service

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. 🗄 Репозиторий заархивирован
  2. Calltouch MCP — коллтрекинг и звонки с рекламы в диалоге с нейросетью
  3. Установка
  4. Авторизация
  5. Инструменты (5)
  6. Скиллы (2)
  7. Примеры запросов
  8. Разработка
  9. Реферальная программа
  10. Лицензия

🗄 Репозиторий заархивирован

Разработка переехала в theYahia/WWmcp — монорепозиторий MCP-серверов для незападных API: СНГ, MENA, Африка, LATAM, Юго-Восточная Азия. Общее ядро @theyahia/mcp-core, единый CI, единый релизный конвейер.

Актуальная версия того, что лежало здесь: servers/calltouch/

Пакет в npm прежний — @theyahia/calltouch-mcp, ставится и работает как раньше. Здесь больше ничего не обновляется. Задачи и pull request'ы — в WWmcp.

Archived — development moved to theYahia/WWmcp, a monorepo of MCP servers for non-Western APIs. The current version of this package now lives at servers/calltouch/. The npm package @theyahia/calltouch-mcp is unchanged. Please open issues and pull requests there.

Calltouch MCP — коллтрекинг и звонки с рекламы в диалоге с нейросетью

Если вы искали, как спросить у ИИ, сколько звонков пришло с рекламы за сегодня, найти пропущенные обращения или свести источники трафика со звонками без выгрузок — это оно. 5 инструментов + 2 скилла поверх API Calltouch: звонки с UTM-разметкой, агрегированная статистика, лиды, источники и теги. Stdio + Streamable HTTP.

Установка

Claude Desktop
{
  "mcpServers": {
    "calltouch": {
      "command": "npx",
      "args": ["-y", "@theyahia/calltouch-mcp"],
      "env": {
        "CALLTOUCH_TOKEN": "ваш_токен",
        "CALLTOUCH_SITE_ID": "ваш_site_id"
      }
    }
  }
}
Claude Code
claude mcp add calltouch -e CALLTOUCH_TOKEN=ваш_токен -e CALLTOUCH_SITE_ID=ваш_site_id -- npx -y @theyahia/calltouch-mcp
Smithery

npx -y @smithery/cli install @theyahia/calltouch-mcp --client claude
Streamable HTTP
npx @theyahia/calltouch-mcp --http
# POST http://localhost:3000/mcp
# GET  http://localhost:3000/health

Порт настраивается через PORT=8080.

Авторизация

ПеременнаяОписание
CALLTOUCH_TOKENAPI-токен из личного кабинета Calltouch (обязательно)
CALLTOUCH_SITE_IDID сайта в Calltouch (обязательно)

Base URL: https://api.calltouch.ru/calls-service/RestAPI/

Инструменты (5)

ИнструментОписание
get_callsСписок звонков с детализацией: номер, источник, длительность, UTM
get_statisticsАгрегированная статистика: всего, уникальных, целевых, пропущенных
get_leadsСписок лидов: заявки с сайта, формы обратной связи
get_sourcesИсточники трафика: каналы, кампании, эффективность
get_tagsТеги звонков: категории и метки

Скиллы (2)

СкиллОписание
skill_calls_todayЗвонки за сегодня — быстрый отчёт
skill_sourcesЭффективность источников — топ по звонкам

Примеры запросов

Покажи все звонки за сегодня
Какая статистика звонков за последнюю неделю?
Какие лиды пришли за март?
Какие источники самые эффективные?
Покажи теги за этот месяц

Разработка

npm install
npm test
npm run dev          # stdio
npm run dev:http     # HTTP на порту 3000

Реферальная программа

Calltouch предлагает реферальную программу: 15% пожизненно с каждого приведённого клиента. Подробности: calltouch.ru/partners

Лицензия

MIT

Telegram: @vhodvai

الأسئلة الشائعة

ما هو io.github.theYahia/calltouch-mcp؟

MCP server for Calltouch API — call tracking, call statistics. Token auth.

كيف أثبّت io.github.theYahia/calltouch-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add calltouch-mcp -e 'CALLTOUCH_TOKEN=<your calltouch_token>' -- npx -y @theyahia/calltouch-mcp@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.theYahia/calltouch-mcp إلى مفتاح API؟

نعم. يتطلب CALLTOUCH_TOKEN، وتضبطها في إعداداته.

هل io.github.theYahia/calltouch-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.theYahia/calltouch-mcp؟

ينشره theYahia. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.