> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shanone.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Shanone MCP サーバー

> 32ツールの構成、プラン、課金とアカウント選択。

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

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

## ツール一覧

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

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

## 推奨する使い方

1. **外部ツール:** search\_tools（inputSchema同梱）→ execute\_tool。schemaRef の場合や list\_service\_tools の後に必要な場合のみ get\_tool\_schema を呼びます。
2. **Gmail のアカウント選択:** list\_connections → 必要に応じて check\_connection → connection\_id を明示して execute\_tool。
3. **スキル（Plus 以上）:** list\_skills → get\_skill → エージェントが指示に沿って実行。追加ファイルも一覧・読み取り・検索できます。
4. **管理操作:** list\_services → 権限・引数制約の設定 → get\_permission\_summary などで確認。

## 集計と利用枠

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

[全パラメーターとエラー](/ja/mcp/tools-reference) · [接続設定](/ja/mcp/setup)
