AIエージェント（MCP）
ツールセットとツール
AmICited MCPサーバーが、エージェントのコンテキストを圧迫せずに300以上のツールを公開する仕組みです。少数の公開ツール、残りを見つけて実行するための4つのメタツール、そして12のツールセットで構成されます。
AmICited MCPサーバーは、ダッシュボードでできることすべてに対応する、300以上のツールを登録しています。すべてのリクエストでそれらの定義をモデルに渡すと、作業を始める前にコンテキストの大部分を消費してしまい、非常に長いリストからのツール選択はモデルにとってかえって不得意になります。そのため、サーバーは段階的に情報を開示します。クライアントには短いリストが表示され、エージェントは必要になったときに残りを調べます。
これらを自分で管理する必要はありません。エージェントは、サーバーの指示とusing-amicited スキルに導かれて、このパターンに自動的に従います。このページでは、エージェントが何をしているかを説明します。これにより、やり取りの記録を読んだり、意図的に対象範囲を絞ったりできます。
クライアントに表示されるもの#
tools/list は、固定された小さなセットを公開します。
| ツール | 用途 |
|---|---|
list_domains | ワークスペース内のドメインと、他のすべてのツールが必要とするID |
list_prompts | ドメインの追跡中のプロンプト |
list_competitors | ドメインの追跡中の競合 |
list_tags | ドメインのプロンプトタグ |
prompt_analytics | AIでの可視性の主要な数値 |
report_link | アプリ内の任意のレポートや設定ページへの有効なリンク |
list_toolsets | 12の製品領域を、1行の説明とツール数付きで表示 |
search_tools | やりたいことからツールを検索 |
describe_tool | 1つのツールの完全な入力スキーマを読み取り |
read_tool | 読み取り専用ツールを名前で実行 |
run_tool | 書き込みやクレジットを消費するツールを含め、任意のツールを名前で実行 |
このリストは会話の間ずっと変わらないため、クライアントのプロンプトキャッシュが有効なままとなり、長いセッションでも高速かつ低コストに保てます。
検索、確認、実行#
その他のツールには、3つのステップで到達します。
search_tools {"query": "which prompts cite competitors but not us"}
describe_tool {"name": "seo_get_citation_gap_invisible_winners"}
read_tool {"name": "seo_get_citation_gap_invisible_winners", "arguments": {...}}search_toolsは、名前、説明、ツールセットでツールをランク付けします。うろ覚えの名前ではなく、平易な言葉での質問（「サイトはダウンしているか」「顧客生涯価値」）で使うと最も効果的です。空のクエリでtoolsetを渡すと1つの領域を一覧でき、offsetを増やすと大きな領域をページ送りできます。describe_toolは、実際の引数スキーマとツールの種類（kind）を返します。ツールによってフラットな引数を取るものと、ネストされたqueryオブジェクトを取るものがあるため、エージェントは実行前に必ずこれを呼び出すべきです。read_toolは、種類がreadのツール、つまり自社データの無料で繰り返し可能な読み取りを実行します。それ以外は拒否されます。そのため、読み取り専用としてマークされ、慎重なクライアント（例えば承認をオフにしたCodex）でも、確認のために止まることなく使えます。run_toolは、他の3つの種類を含め、すべてを実行します。
| 種類 | 意味 |
|---|---|
read | ワークスペースのデータを読み取ります。無料です。 |
external | サードパーティのAPI（Google、Bing、Meta、OpenAI、データプロバイダー）を呼び出す、またはクレジットを消費します |
write | ワークスペースのデータを作成または編集します。amicited:write スコープが必要です |
destructive | データを削除する、または実際の広告費を開始・停止します |
公開されていないツールだからといって、保護が弱いわけではありません。すべてのツールが、権限、プランの上限、クレジットを自分でチェックし、run_tool は対象ツール自身の書き込みチェックを適用します。そのため、読み取り専用のトークンでは、これを経由して書き込みに到達することはできません。
12のツールセット#
すべてのツールは、ちょうど1つのツールセットに属します。エージェントはそれを使って検索する場所を決め、ユーザーはそれを使って特定の領域を固定できます（下記参照）。
| ツールセット | 対象範囲 | ツールの例 |
|---|---|---|
domains | ドメイン、競合、タグ。他のすべてのツールセットが受け取るID | list_domains, create_competitor, create_tag |
prompts | 追跡中のプロンプトとその回答。作成、スケジュール、回答の読み取り、ファンアウト、カバレッジ | create_prompts_bulk, list_prompt_responses, prompt_query_fanouts, get_prompt_coverage |
visibility | ドメインがAIの回答に表示される場所。時系列の指標、引用されたソース、シェア・オブ・ボイス、セマンティックマップ | get_dashboard_metrics, get_prompt_detail, get_citations_timeseries, list_top_cited_domains |
organic_search | Google Search ConsoleとBing Webmaster Tools。クエリ、ページ、インデックスカバレッジ、サイトマップ、URLの送信 | gsc_get_queries, gsc_inspect_url, bing_wmt_get_pages, indexnow_submit |
paid_ads | Google Ads、Microsoft Ads、Meta、LinkedInのレポート。広告費、キャンペーン、キーワード、検索語句、真のROAS | google_ppc_get_search_terms, bing_ppc_get_campaigns, meta_profit_true_roas, linkedin_performance |
chatgpt_ads | ChatGPT Ads。パフォーマンスの読み取り、キャンペーン、広告グループ、クリエイティブ、コンバージョントラッキングの作成と編集 | ads_get_insights, ads_list_campaigns, ads_create_campaign |
seo_reports | ウェアハウスで構築されたオーガニック分析。変動、あと一歩の順位、CTRと引用のギャップ、カニバリゼーション、インデックスの肥大化 | seo_get_striking_distance, seo_get_citation_gap_invisible_winners, seo_get_cannibalization_queries |
eshop | EC分析。売上と利益率、商品、顧客、コホートとLTV、セグメント、コスト入力 | eshop_get_kpis, eshop_get_products, eshop_get_ltv, eshop_get_cost_mix |
uptime | モニター、ハートビート、インシデント、SLAレポート、メンテナンスウィンドウ、ステータスページ | uptime_list_monitors, uptime_sla_report, heartbeat_create, status_page_create |
content | AI記事、アノテーション、接続されたショップの内部リンクルール | article_generate, annotation_create, link_building_list_rules |
audits | AIエージェント向けのサイトヘルス。エージェントアクセシビリティ、llms.txtのレビュー、Web Vitals、鮮度、サイト監査、バックリンク | get_agent_accessibility, llms_txt_get_comparison, get_web_vitals, backlinks_list |
workspace | 接続済みのデータプラットフォーム、同期ステータス、インポート、通知の受信トレイ | platform_list_domain_connections, platform_get_sync_status, inbox_list_entries |
ツール名には領域ごとのプレフィックス（gsc_、bing_wmt_、google_ppc_、meta_、eshop_、uptime_、ads_）が付いているため、やり取りの記録を簡単に見渡せます。
?toolsets= でツールセットを固定する#
クライアントによっては、ネストされた run_tool の呼び出しをうまく扱えない場合があり、また1つの領域だけを見せる限定的なエージェントを使いたいこともあります。その場合は、接続URLにクエリパラメータを追加します。
https://api.flowhunt.io/mcp/amicited?toolsets=eshop,uptime
https://api.flowhunt.io/mcp/amicited?toolsets=all指定したツールセットは、コアセットと並んで tools/list にネイティブに公開されます。all はすべてを公開しますが、コンテキストの節約効果は失われるため、独自のツール検索を行うクライアントでのみ使用してください。不明な名前は拒否されずに無視されるため、ある領域が表示されない場合はスペルを確認してください。選択は接続の存続期間中固定されており、会話の途中でどのツールもこれを広げることはできません。
ページ、フィールド、上限#
- 25行ごとのページ。 行のリストを返すすべてのツールは、デフォルトで25行を返し、1回の呼び出しで最大500行までです。さらに行がある場合、レスポンスには
has_moreと、次の呼び出しで渡す値（ネイティブのオフセットやページ、またはnext_cursor）を含むpagingブロックが含まれます。 fields。 行のリストを1つ返すツールは、必要な列だけを返すためのfields配列を受け付けます。行に存在しない列は、無視されずに拒否されます。- ワークスペースの引数なし。 ワークスペースは認証情報によって固定されるため、ワークスペースIDを受け取るツールはありません。ほぼすべてのツールが、
list_domainsから得られるdomain_idを必要とします。 - 1時間あたりの上限。 ツール呼び出しは、ワークスペースごとに1時間単位でカウントされます（接続をご覧ください）。ツールの一覧表示とスキルの読み取りは無料です。
read_toolやrun_toolを通じて到達する非公開ツールは、1回とカウントされます。