Shanone MCP サーバー - Shanone Documentation

Analyticsの3ツールはNode.js 0.7.0／Python 0.4.0のソースに追加されています。Remote MCPの配備とnpm/PyPI公開は別工程です。接続先の tools/list で提供状況を確認してください。

Remote MCP は 32ツールを公開します。内訳はヘルスチェック１、検索・スキーマ・実行４、接続管理２、スキル13、サービス・権限管理９、Analytics３です。

ツール一覧

ツール	用途	プラン・課金
`shanone_health_check`	MCP の接続、API キー認証、バックエンドの稼働状態を確認します。外部サービスの認証は検証しません。	Free 以上・非課金
`shanone_search_tools`	上位候補の入力スキーマも同梱して検索します。schemaRef の場合のみ追加取得し、全件列挙には list_service_tools を使います。	Free 以上・非課金
`shanone_list_service_tools`	指定サービスのツールをページ単位で取得します。全件取得する場合は後続ページも取得してください。	Free 以上・非課金
`shanone_get_tool_schema`	schemaRef の場合に入力スキーマを追加取得するか、既知のスキーマを更新します。	Free 以上・非課金
`shanone_list_connections`	呼出元が参照できる保存済み接続を一覧表示します。登録済みであることは、認証が現在も有効であることを意味しません。	Free 以上・非課金
`shanone_check_connection`	読み取り専用の外部 API を使い、保存済み接続の有効性を確認します。service を省略すると、接続済みサービスをページ単位で確認します。	Free 以上・非課金
`shanone_execute_tool`	連携ツールを実行します。実行結果の外側のステータスと外部サービスの結果を確認してください。呼び出しの完了だけで業務処理の成功とは判断しません。	Free 以上・実行先に従う
`shanone_get_tool_usage`	利用量を集計	Plus以上・成功時1回
`shanone_search_tool_logs`	実行ログを検索	Plus以上・成功時1回
`shanone_get_tool_log`	実行ログ1件の詳細を取得	Plus以上・成功時1回
`shanone_list_skills`	保存済みスキルを新しい順に一覧表示します。query は任意で、空の場合は対象の保存済みスキルをページ単位で取得します。	Plus 以上・成功時課金
`shanone_get_skill`	スキルの名前、説明、指示本文を取得します。指示の実行は呼出元のエージェントが行い、この呼び出し自体がワークフローを実行するわけではありません。	Plus 以上・成功時課金
`shanone_create_skill`	再利用可能なスキルを作成します。３項目すべてに空でない値が必要です。description と body は summary と instructions として保存されます。	Plus 以上・成功時課金
`shanone_update_skill`	既存スキルを更新します。任意項目は空でない値だけを更新し、空文字の場合は既存の値を保持します。	Plus 以上・成功時課金
`shanone_delete_skill`	スキルを完全に削除します。	Plus 以上・成功時課金
`shanone_list_skill_files`	スキルに付属する追加ファイルのパスやサイズを一覧表示します。指示本文は get_skill で取得します。	Plus 以上・成功時課金
`shanone_read_skill_file`	スキルのテキストファイルを読み取ります。バイナリの場合は内容の代わりに説明を返すため、表示やダウンロードにはダッシュボードを使ってください。	Plus 以上・成功時課金
`shanone_write_skill_file`	UTF-8 テキストファイルを作成、または上書きします。親フォルダーがなければ自動作成します。	Plus 以上・成功時課金
`shanone_delete_skill_file`	スキルに付属するファイルを１件削除します。	Plus 以上・成功時課金
`shanone_grep_skill`	正規表現でスキルファイルを検索します。結果にはパスと行番号が含まれます。打ち切られた場合は検索条件を絞ってください。	Plus 以上・成功時課金
`shanone_create_skill_folder`	スキル内に空のフォルダーを作成します。write_skill_file は親フォルダーを作成するため、ファイル書き込み前の必須操作ではありません。	Plus 以上・成功時課金
`shanone_delete_skill_folder`	フォルダーと、その中のファイル・サブフォルダーを削除します。元に戻せない操作です。	Plus 以上・成功時課金
`shanone_rename_skill_path`	ファイルまたはフォルダーを移動・改名します。フォルダーの内容も移動します。移動先が存在する場合は上書きせずエラーになります。	Plus 以上・成功時課金
`shanone_list_services`	登録済みサービスの名前、表示名、ツール数を取得します。管理者ロールは不要です。	Free 以上・非課金
`shanone_list_user_tool_permissions`	対象ユーザーのツール・サービス権限の個別設定を一覧表示します。	Free 以上・非課金
`shanone_set_user_tool_permission`	対象ユーザーの１つのツールを許可・拒否します。ツール単位の設定は、サービス単位やロールの既定設定より優先されます。	Free 以上・非課金
`shanone_set_user_service_permission`	対象ユーザーのサービス単位のツール利用を許可・拒否します。ツール単位の個別設定がある場合はそちらが優先されます。	Free 以上・非課金
`shanone_get_permission_summary`	対象ユーザーの許可・拒否されたサービスとツールを集計します。	Free 以上・非課金
`shanone_batch_set_user_permissions`	最大500件のサービス・ツール権限操作をまとめて適用します。１件の失敗で全体は中断しないため、各操作の結果を確認してください。	Free 以上・非課金
`shanone_get_tool_parameter_policy`	対象ユーザーのツールに設定された引数制約を取得します。ツールの利用可否と、許可する引数の値は別の制御です。	Free 以上・非課金
`shanone_set_tool_parameter_policy`	１つの引数フィールドの制約を設定・置換します。制約は実行時にサーバー側で適用されます。	Free 以上・非課金
`shanone_delete_tool_parameter_policy`	１つの引数フィールドの制約を削除します。ツール自体の許可・拒否設定は変更しません。	Free 以上・非課金

プランとは別に、API キー・ユーザー・リソースの権限を確認します。権限の変更・他ユーザーの権限参照には Root または委任された SA2 権限が必要です。

推奨する使い方

外部ツール: search_tools（inputSchema同梱）→ execute_tool。schemaRef の場合や list_service_tools の後に必要な場合のみ get_tool_schema を呼びます。
Gmail のアカウント選択: list_connections → 必要に応じて check_connection → connection_id を明示して execute_tool。
スキル（Plus 以上）: list_skills → get_skill → エージェントが指示に沿って実行。追加ファイルも一覧・読み取り・検索できます。
管理操作: list_services → 権限・引数制約の設定 → get_permission_summary などで確認。

集計と利用枠

管理操作は非課金でも Analytics に記録されます。スキルは成功時だけ１回分を消費します。接続確認は内部の確認用 API を含めて非課金で、親１回だけを集計します。外部ツールの実行は実行先の通常の課金ルールに従います。全パラメーターとエラー · 接続設定