mcpField
C
calltouch-mcp

calltouch-mcp

ローカル
github.com/theYahiaデータ・分析08 週間前に更新

calltouch-mcp について

calltouch-mcpは、通話トラッキングや広告分析のためにMCPクライアントをCalltouch APIへ接続します。通話記録、統計、リード、流入元、タグを扱い、開発はWWmcpへ移行しています。

主な機能

  1. 01流入元やUTM付きの通話を閲覧
  2. 02通話の集計統計を確認
  3. 03リードの一覧表示
  4. 04流入元とタグの確認
  5. 05当日の通話・流入元分析スキル

活用シーン

  1. 01今日の着信を確認
  2. 02不在着信やリード記録を探す
  3. 03流入元ごとの通話を比較

MCP 対応

Calltouch APIを扱う5つのツールと2つのスキルをMCPクライアントに公開します。stdioとStreamable HTTPに対応し、CalltouchのトークンとサイトIDで認証します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"theyahia-calltouch": {
"command": "npx",
"args": [
"-y",
"@theyahia/calltouch-mcp"
],
"env": {
"CALLTOUCH_TOKEN": "<CALLTOUCH_TOKEN>"
}
}
}
}
起動コマンドnpx -y @theyahia/calltouch-mcp
設定が必要な環境変数
CALLTOUCH_TOKENシークレットAPI key for the service

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@theyahia/calltouch-mcp1.0.1

ツール

2

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
pagenumberいいえページ番号(デフォルトは 1)
limitnumberいいえКоличество записей (по умолчанию 50)
sourcestringいいえФильтр по источнику трафика
date_tostringはいДата окончания в формате dd/MM/yyyy
date_fromstringはいДата начала в формате dd/MM/yyyy

詳細

🗄 リポジトリはアーカイブされました

開発は theYahia/WWmcp に移行しました。CIS、MENA、アフリカ、LATAM、東南アジアなど、非西洋圏の API 向け MCP サーバーをまとめたモノレポです。共通コア @theyahia/mcp-core、統一された CI、統一されたリリースパイプラインを備えています。

ここにあったものの最新版は servers/calltouch/ にあります。

npm パッケージは従来どおりです — @theyahia/calltouch-mcp。これまでどおりインストールして利用できます。 ここでの更新は今後ありません。課題やプルリクエストは WWmcp でお寄せください。

アーカイブ済み — 開発は theYahia/WWmcp に移行しました。 非西洋圏の API 向け MCP サーバーをまとめたモノレポです。 このパッケージの最新版は servers/calltouch/ にあります。 npm パッケージ @theyahia/calltouch-mcp に変更はありません。 課題やプルリクエストはそちらでお寄せください。

Calltouch MCP — AI との対話で、広告経由のコールトラッキングと通話を確認

今日、広告経由で何件の電話があったかを AI に尋ねたり、不在着信を見つけたり、データをエクスポートせずにトラフィックソースと通話をまとめたりする方法をお探しなら、これが役立ちます。Calltouch API を利用した 5 つのツールと 2 つのスキル:UTM パラメーター付きの通話、集計統計、リード、流入元、タグに対応しています。Stdio と Streamable HTTP をサポートしています。

npm License: MIT

インストール

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

smithery badge

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_TOKENCalltouch の個人アカウントから取得した API トークン(必須)
CALLTOUCH_SITE_IDCalltouch のサイト ID(必須)

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

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。