# MCP serverツール設定

Agent BuilderやMCPノードで利用できるMCPserver各ツールの説明や設定方法を記載しています。

<mark style="color:red;">※Allganizeと記載のあるMCPツールのAPIキーはプロジェクト設定＞全般＞APIキーでご確認いただけます。</mark>\ <mark style="color:red;">その他の各MCPツールで必要になるAPIキーは自社でご用意されたAPIキーをご利用ください。</mark>

## 目次

* [Allganize Alli](#agent-creation)
* [Allganize Document](#agent-creation-1)
* [Allganize Sample Test MCP Server](#agent-creation-2)
* [Box MCP Server](#agent-creation-3)
* [DOCX Template MCP Server](#agent-creation-4)
* [Everything](#agent-creation-5)
* [Fetch](#agent-creation-6)
* [Image Creation MCP Server](#agent-creation-7)
* [OpenAI Tools](#agent-creation-8)
* [Run Python](#agent-creation-9)
* [SERPER API MCP Server](#agent-creation-10)
* [Salesforce MCP Server](#agent-creation-11)
* [Sequential Thinking](#agent-creation-12)
* [Slack MCP Server](#agent-creation-13)
* [Snowflake MCP Server](#agent-creation-14)
* [Time](#agent-creation-15)
* [Time MCP Server](#agent-creation-16)

### Allganize Alli <a href="#agent-creation" id="agent-creation"></a>

**概要**

Alli LLM App Marketの基本的な機能を利用できます。

#### ツール名：search\_documents

* ツール概要
  * ナレッジベースから、セマンティック検索（キーワード一致ではなく文章の“意味”を理解して探す検索）を使用して関連ドキュメントを検索します。

    このツールは、検索クエリに一致する ドキュメントを見つけます。\
    各結果には、ドキュメントのタイトルと全文、作成・更新日時などのメタデータが含まれます。
* 利用例
  * 「会社の方針」に関するすべての文書を探す
  * 特定のハッシュタグが付けられた文書を検索する
  * 特定の条件に一致する文書を見つける
* 入出力（引数と戻り値）
  * 戻り値（出力）: タイトル、全文、メタデータを含む文書のリスト

| 設定項目                          | 説明                                       |
| ----------------------------- | ---------------------------------------- |
| query                         | 検索クエリ                                    |
| hashtags                      | 指定したハッシュタグが付与されたドキュメントから検索します。           |
| exclude\_hashtags             | 検索結果から除外するハッシュタグを指定します。                  |
| hashtags\_operation           | 検索手法をANDかORで指定します。デフォルトはOR検索です。          |
| exclude\_hashtags\_operatiion | 除外する複数のハッシュタグをANDかORで指定します。デフォルトはOR検索です。 |

#### ツール名：search\_faqs

* ツール概要
  * 検索クエリに一致する FAQを検索します。

    このツールは、質問と回答のペアで構成された構造化された FAQを検索します。\
    検索クエリとの関連性に基づき、FAQ のランキングが返されます。
* 利用例
  * 「パスワードリセット」に関する FAQ を探す
  * 特定カテゴリのよくある質問を検索する（ハッシュタグを使用）
  * 顧客の特定の質問に対する回答を見つける
* 入出力（戻り値）
  * 戻り値（出力）: 質問文、回答テキスト、作成・更新日時などのメタデータを含む FAQ エントリのリスト

| 設定項目                          | 説明                                       |
| ----------------------------- | ---------------------------------------- |
| query                         | 検索クエリ                                    |
| hashtags                      | 指定したハッシュタグが付与されたFAQから検索します。              |
| exclude\_hashtags             | 検索結果から除外するハッシュタグを指定します。                  |
| hashtags\_operation           | 検索手法をANDかORで指定します。デフォルトはOR検索です。          |
| exclude\_hashtags\_operatiion | 除外する複数のハッシュタグをANDかORで指定します。デフォルトはOR検索です。 |

#### ツール名：generative\_answer

* ツール概要
  * ナレッジベースのドキュメントをもとに、AI による回答を生成します。

    このツールは 2つのステップ で動作します：

    1. ナレッジベースを検索して関連するドキュメントを見つける
    2. LLM を使用して、見つけたドキュメントに基づき自然言語で回答を生成する

    生成される回答は複数の情報源から統合され、必要に応じてどのドキュメントを参照したかの引用を含めることもできます。
* 利用例
  * 「会社の休暇制度はどうなっていますか？」
  * 「パスワードをリセットするにはどうすればいいですか？」
  * 「ソフトウェアの動作環境は何ですか？」
  * 特定のドキュメントカテゴリ（ハッシュタグを使用）に絞った回答の生成
* 入出力（戻り値）
  * 戻り値（出力）: 生成された回答テキスト、必要に応じて参照ドキュメントの引用

| 設定項目                          | 説明                                                                                                                                                                                                                                                                                                                                                  |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| query                         | 検索クエリ                                                                                                                                                                                                                                                                                                                                               |
| hashtags                      | 指定したハッシュタグが付与されたFAQから検索します。                                                                                                                                                                                                                                                                                                                         |
| exclude\_hashtags             | 検索結果から除外するハッシュタグを指定します。                                                                                                                                                                                                                                                                                                                             |
| model\_name                   | 回答生成に利用するモデルを指定します。デフォルトモデルはGPT4oです。                                                                                                                                                                                                                                                                                                                |
| include\_citations            | 回答生成結果に根拠となるドキュメント情報を含めるかどうかを"true"か"false"で指定します。                                                                                                                                                                                                                                                                                                  |
| prompt\_group\_id             | 回答生成に使用するプロジェクトのグループプロンプトを選択します。この設定は、デフォルトで準備されたグループプロンプトから変更を行い利用している場合などに有効です。 IDはプロジェクト設定>プロンプト管理>回答生成タブの選択します。使用するグループプロンプトを選択した際に表示されるURLからIDが確認できます。 例 ：<https://app.alli.ai/projects/UHJvamVjdDo2NDljYTRjZDMzMGY2MDZkYWRjOPOjNjE=/settings/prompt-management/generative-answer/groups/TExNUHJvbXB0R3JvdXA6NjUzNzc3MzA5GHUyMGE2ZjlhM2Q5OTIw> |
| knowledge\_base\_ids          | 検索を特定のドキュメントIDに限定します。                                                                                                                                                                                                                                                                                                                               |
| hashtags\_operation           | 検索手法をANDかORで指定します。デフォルトはOR検索です。                                                                                                                                                                                                                                                                                                                     |
| exclude\_hashtags\_operatiion | 除外する複数のハッシュタグをANDかORで指定します。デフォルトはOR検索です。                                                                                                                                                                                                                                                                                                            |

#### ツール名：search\_knowledge\_base\_nodes

* ツール概要
  * ナレッジベース内のファイルやフォルダを、メタデータや属性で検索します。

    このツールは、ドキュメント内の 内容ではなく、ナレッジベースの構造自体（ファイルやフォルダ）を検索します。\
    各ファイル・フォルダのメタデータ（名前、種類、サイズ、処理状況、ハッシュタグ、作成・更新日時など）を返します。
* 利用例
  * 特定フォルダ内のすべての PDF ファイルを一覧表示する
  * 「quarterly-report」タグが付いたすべての文書を検索する

    処理中のファイルを確認する
  * ナレッジベースのフォルダ構造を閲覧する
  * 名前パターンでファイルを検索する
* 入出力（戻り値）
  * 戻り値（出力）:ナレッジベース内のノード（ファイル／フォルダ）のリストとメタデータ
    * ID
    * 名前
    * 種類
    * サイズ
    * 状態
    * ハッシュタグ
    * 親フォルダ
    * 作成・更新日時

| 設定項目                         | 説明                                                                                                                                                                  |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| search\_term                 | フィルタリングするための検索キーワード                                                                                                                                                 |
| hashtags                     | 指定したハッシュタグが付与されたドキュメントから検索します。                                                                                                                                      |
| exclude\_hashtags            | 検索結果から除外するハッシュタグを指定します。                                                                                                                                             |
| parent\_folder\_ids          | 検索対象とするフォルダID。最上位レベルに挿入するにはnull。                                                                                                                                    |
| node\_type                   | file、またはfolderを指定します。                                                                                                                                               |
| process\_state               | <p>解析プロセスのステータスを以下から指定します</p><p>・initializing ・parsing ・parsing\_fail ・completed ・retrying ・post\_parsing ・post\_parsing\_fail ・post\_completed ・post\_retrying</p> |
| limit                        | 表示する結果数を制限します。デフォルトは10です。最大値は 100 です。                                                                                                                               |
| after                        | API でレスポンス本文を取得できるカーソル値を入れることができます (カーソルベースのページング) このフィールドが指定されていない場合、サーバーはフィルタリングされた値の最初の値から制限まで送信した回数を返します。                                                       |
| hashtags\_operation          | 検索手法をANDかORで指定します。デフォルトはOR検索です。                                                                                                                                     |
| exclude\_hashtags\_operation | 除外する複数のハッシュタグをANDかORで指定します。デフォルトはOR検索です。                                                                                                                            |

#### ツール名：get\_knowledge\_base\_text

* ツール概要
  * 特定のナレッジベース内のドキュメントの、プレーンテキスト全体を取得します。

    このツールは、ナレッジベース内のドキュメントファイルから すべてのテキスト内容 を抽出して返します。\
    テキストは元のファイル形式（PDF、DOCX など）から解析・整形され、プレーンテキストとして取得されます。
* 利用例
  * 特定のポリシー文書の全文を読む
  * 検索で見つけたドキュメントから内容を抽出し、さらに処理する
  * 要約や分析のためにドキュメント全文を取得する
  * 特定の詳細を確認するために内容を取得する
* 入出力（戻り値）
  * 戻り値（出力）: ドキュメントのタイトル、ドキュメントの全文テキスト

| 設定項目     | 説明                 |
| -------- | ------------------ |
| node\_id | ナレッジベースノードIDを指定します |

#### ツール名：retrieval

* ツール概要
  * 質問内容に対して、最も関連性の高いドキュメントのページやセクションを取得します。

    このツールは、ナレッジベース内の すべての文書ページ を対象に、キーワード検索（BM25） と セマンティック検索（ベクトル類似度） を組み合わせたハイブリッド方式で検索します。\
    検索結果として、ページ単位の 抜粋テキスト を関連性順に返します。
* 利用例
  * 「データ保持ポリシー」に言及しているページを探す
  * 「従業員福利厚生」について記載されているページはどれか
  * セキュリティ要件に関する抜粋箇所を特定する
  * 特定の文書セクションから引用や証拠を探す
  * 特定のトピックに関する文脈を、正確な原文テキストで取得する
* 入出力（戻り値）
  * 戻り値（出力）:
  * ページ単位のドキュメント情報リスト（以下の項目を含む）\
    ・ランキング（関連度スコア）\
    ・ドキュメントタイトル\
    ・ページ番号またはシート名\
    ・そのページの正確なテキスト内容\
    ・ナレッジベース ID（参照用）

| 設定項目                         | 説明                                                                                                     |
| ---------------------------- | ------------------------------------------------------------------------------------------------------ |
| question                     | 検索クエリ                                                                                                  |
| max\_document\_clues         | <p>関連ページを取得する数を決定します。<br>デフォルトは3です。</p>                                                                |
| bm25\_score\_weight          | キーワード検索の重みです。この値が高いほど、キーワードスコアがより反映されます。0から9の間の値が適切であり、値が0の場合はキーワード検索が使用されないことを意味します。デフォルト値は9です。       |
| text\_vector\_score\_weight  | ドキュメント内容に対するセマンティック検索の重みです。この値が高いほど、より多く反映されます。0から9の値が適切で、値が0の場合は文書内容に対するセマンティック検索が使用されません。デフォルト値は1です。 |
| title\_vector\_score\_weight | ドキュメントタイトルに対するセマンティック検索の重みです。同様に、0から9の間の値が適切であり、値が0の場合は文書タイトルに対するセマンティック検索が使用されないことを意味します。デフォルト値は0です。  |
| hashtags                     | 指定したハッシュタグが付与されたドキュメントから検索します。                                                                         |
| hashtags\_operator           | 検索手法をANDかORで指定します。デフォルトはOR検索です。                                                                        |
| exclude\_hashtags            | 検索結果から除外するハッシュタグを指定します。                                                                                |
| exclude\_hashtags\_operator  | 除外する複数のハッシュタグをANDかORで指定します。デフォルトはOR検索です。                                                               |
| target\_folders              | 検索対象フォルダ名                                                                                              |
| folder\_ids                  | 検索対象のフォルダーのID                                                                                          |
| knowledge\_base\_ids         | 特定のナレッジベース内を検索するためのID                                                                                  |
| use\_keywords                | <p>検索のためのキーワードを抽出して使用するかどうか<br>を""true""または""false""で指定します。</p>                                        |
| use\_clue\_feedback          | <p>検索結果を改善するためにフィードバックデータを使用するかどうか<br>を""true""または""false""で指定します。</p>                                 |

### Allganize Document <a href="#agent-creation" id="agent-creation"></a>

**概要**

指定のドキュメントのインプット、アウトプット等を行います。

#### ツール名：Download V1

* ツール概要
  * URL または Allganize システムからファイルをローカルの一時ストレージにダウンロードします。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * tmpfs パス、ローカルパス、メタデータ

| 設定項目       | 説明                                                                                                    |
| ---------- | ----------------------------------------------------------------------------------------------------- |
| file\_path | Allganizeシステム内のダウンロード用HTTP/HTTPS URLまたはファイル名（設定例：<https://example.com/file.pdf>' または 'document.docx'） |
| file\_name | 一時ファイルのファイル名。（設定例：document.csv'、'data.xlsx'）                                                          |

#### ツール名：Upload V1

* ツール概要
  * tmpfs ストレージから Allganize システムにファイルをアップロードします。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * アップロード結果、ダウンロード URL、メタデータ

| 設定項目       | 説明                                                                                     |
| ---------- | -------------------------------------------------------------------------------------- |
| file\_name | 一時ファイルのファイル名。（設定例：<https://example.com/file.pdf>' または 'document.docx'）                 |
| tmpfs      | ダウンロードツールからのtmpfsパス（設定例：document.csv'、'data.xlsx'）                                     |
| filename   | Allganizeシステムで希望するファイル名（必須）。元のファイル名と異なっていても構いません。（設定例：tmpfs\://workspace/document.pdf） |

#### ツール名：Write V1

* ツール概要
  * コンテンツを一時ファイルに書き込み、tmpfs パスを返します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * tmpfs のパスとメタデータ

| 設定項目     | 説明                                           |
| -------- | -------------------------------------------- |
| content  | 一時ファイルに書き込むコンテンツ。テキスト、JSON、XMLなどを指定できます。     |
| filename | 一時ファイルのファイル名。（設定例：document.txt'、'data.json'） |

#### ツール名：Extract Ast From Docx V1

* ツール概要
  * 実行の分割/マージをサポートして、DOCX ファイルから AST (抽象構文ツリー) を抽出します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * AST構造と処理済みのtmpfsパス
      * ast: 段落と表を含む要素配列を持つドキュメントAST
      * has\_more: 制限を超える要素があるかどうかを示すブール値
      * tmpfs\_path: 後続の操作のための処理済みファイルへのパス

| 設定項目            | 説明                                                                                                                                 |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| tmpfs           | DOCXファイルへのtmpfsパス（必須）。ダウンロードツールから取得したtmpfs\://path/to/file.docx形式である必要があります。（設定例：tmpfs\://contracts/agreement.docx）                |
| extract\_fields | 抽出するRunModelフィールドのリスト（オプション、デフォルト：\['text']）。使用可能なフィールド：'text'、'font'、'size'、'bold'、'italic'、'color'。（設定例：\['text'、'bold'、'font']） |
| from\_element   | ページ区切りの開始要素番号 (オプション、デフォルト: 0)。抽出を開始する 0 ベースのインデックス。                                                                               |
| limit           | 抽出する要素の最大数（オプション、デフォルト：100、最大：100）。ページ区切りのサイズを制御します。                                                                               |

#### ツール名：Apply Ast To Docx V1

* ツール概要
  * 実行の分割/マージをサポートする DOCX ファイルに AST (抽象構文ツリー) の変更を適用します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * 成功ステータスとファイル情報

| 設定項目     | 説明                                                                                                               |
| -------- | ---------------------------------------------------------------------------------------------------------------- |
| tmpfs    | DOCXファイルへのtmpfsパス（必須）。tmpfs\://path/to/file.docx形式である必要があります。ファイルはその場で変更されます。（例：'tmpfs\://drafts/proposal.docx'） |
| elements | アクションベースの操作を持つ要素のリスト。                                                                                            |

#### ツール名：Search V1

* ツール概要
  * インテリジェントなヘッダー検出を備えたスマートなテキスト検索。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * 一致とメタデータを含む検索結果

| 設定項目              |                                                                                                 |
| ----------------- | ----------------------------------------------------------------------------------------------- |
| tmpfs             | tmpfs\:// 検索対象ファイルへのパス。テキスト読み取り可能なファイル形式であればどれでもサポートされます。                                       |
| pattern           | Ripgrep互換の正規表現パターン。                                                                             |
| before\_context   | 一致前の行数（0～20）。                                                                                   |
| after\_context    | 一致後の行数（0～20）。                                                                                   |
| multiline         | 複数行検索モードを有効にします。行の境界をまたいでパターンを一致させることができます。複数行または複数セクションにまたがるコンテンツを検索したい場合に使用します。デフォルトはFalseです。 |
| case\_insensitive | 大文字と小文字を区別しない検索を実行します。デフォルトはFalseです。                                                            |

#### ツール名：Search Ast From Docx V1

* ツール概要
  * 正規表現パターンに一致する DOCX ファイル内の段落を検索し、その AST を返します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * 一致する段落のASTとメタデータ
      * ast: 一致する段落のみを含むドキュメントAST
      * matches\_found: 見つかった一致する段落の数
      * total\_paragraphs\_checked: チェックされた段落の総数
      * regex\_pattern: 使用した正規表現パターン
      * tmpfs\_path: 処理対象ファイルへのパス

| 設定項目          | 内容                                                                                                                 |
| ------------- | ------------------------------------------------------------------------------------------------------------------ |
| tmpfs         | DOCXファイルへのtmpfsパス（必須）。ダウンロードツールから取得したtmpfs\://path/to/file.docx形式である必要があります（例：'tmpfs\://20250714123456/file.docx') |
| regex         | 段落テキストにマッチする正規表現パターン（必須）。完全な正規表現構文をサポートします。                                                                        |
| from\_element | ページ区切りの開始要素番号 (オプション、デフォルト: 0)。検索を開始する 0 ベースのインデックス。                                                               |
| limit         | 返される一致する段落の最大数（オプション、デフォルト：100、最大：100）。結果のページ区切りを制御します。                                                            |

#### ツール名：Apply Global Changes To Docx V1

* ツール概要
  * DOCX ファイル内のすべての段落にグローバル書式設定とテキスト修正を適用します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * 成功ステータス
    * ファイル情報
    * 適用された変更

| 設定項目                 | 説明                                                                                                                                                                                                                     |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| tmpfs                | DOCXファイルへのtmpfsパス（必須）。                                                                                                                                                                                                 |
| font                 | すべてのテキストに適用するフォント名（オプション）。例：「Arial」、「Times New Roman」、「Calibri」。指定しない場合は、フォントは変更されません。                                                                                                                                 |
| font\_size           | すべてのテキストに適用するフォントサイズ（ポイント単位）（オプション）。例：8、12、14。指定しない場合は、フォントサイズは変更されません。                                                                                                                                                |
| word\_replacements   | 単語置換辞書（オプション）。形式：{'old\_word': 'new\_word'}。例：{'old\_term': 'new\_term', 'wrong\_spelling': 'correct\_spelling'}。指定されていない場合、単語置換は適用されません。                                                                              |
| numbers\_conversion  | 数値の幅の変換（オプション）。指定可能な値：'to\_zenkaku'（全角）, 'to\_hankaku'（半角）。指定しない場合は、数値は変更されません。                                                                                                                                        |
| alpha\_conversion    | アルファベットの幅の変換（オプション）。指定可能な値：'to\_zenkaku'（全角）, 'to\_hankaku'（半角）。指定しない場合は、アルファベットは変更されません。                                                                                                                              |
| symbols\_conversion  | 記号の幅の変換（オプション）。指定可能な値：「to\_zenkaku」（全角）、「to\_hankaku」（半角）。指定しない場合は、記号は変更されません。                                                                                                                                         |
| katakana\_conversion | カタカナの幅変換（オプション）。指定可能な値：'to\_zenkaku'（全角）, 'to\_hankaku'（半角）。指定しない場合は、カタカナは変更されません。                                                                                                                                     |
| highlight            | すべてのテキストに適用するハイライトカラー（オプション）。使用可能な色：'yellow'、'cyan'、'green'、'magenta'、'blue'、'red'、'darkBlue'、'darkCyan'、'darkGreen'、'darkMagenta'、'darkRed'、'darkYellow'、'gray25'、'gray50'、'black'、'white'。指定しない場合は、ハイライトカラーは変更されません。 |
| shading              | すべてのテキストに適用する背景のシェーディング色（HEX形式、オプション）を指定します。例：'FFFF00'（黄色）、'FF0000'（赤）、'E6F3FF'（水色）。接頭辞「#」は含めないでください。指定しない場合、シェーディングは変更されません。                                                                                          |

#### ツール名：Read V1

* ツール概要
  * CSV、JSON、コードファイル、ログ、設定ファイルなど、あらゆるテキストファイル形式をサポートします。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * テキストの内容と行情報

| 設定項目        | 説明                                                                                                                                                                          |
| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| tmpfs       | <p>tmpfs\:// は、テキスト読み取り可能なファイルです。</p><p>.md、.txt、.csv、.tsv、.json、.py、.js、.java、.cpp、.go、.rs、.log、.yml、.yaml、.xml、.html、.css、.sql、.sh、.bat、.ini、.cfg、.conf などをサポートしています。</p> |
| from\_lines | 読み取り開始行番号（0 ベース）。デフォルトは 0（先頭から開始）です。                                                                                                                                        |
| read\_lines | 読み取る行数。デフォルトは1000です。大きなドキュメントの場合は、より小さい値を使用してください。                                                                                                                          |

#### ツール名：Search From Json V1

* ツール概要
  * スマート ガイダンス付きの jq 式を使用して JSON データを検索およびフィルター処理します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * フォーマットされた JSON データ、メタデータ、およびオプションのスキーマを含む検索結果

| 設定項目            | 説明                                                          |
| --------------- | ----------------------------------------------------------- |
| tmpfs           | tmpfs\:// 検索するJSONファイルへのパス。有効なJSONファイルである必要があります。           |
| jq\_query       | JSONデータを検索/フィルタリングするためのjq式。                                 |
| output\_format  | 出力形式。                                                       |
| max\_results    | 返される結果の最大数（0の場合は無制限）。大きな結果セットの出力サイズを制限するために使用します。           |
| include\_schema | 結果にJSONスキーマ分析を含めます。Trueの場合、ファイル構造に基づいてJSONスキーマと推奨クエリが返されます。 |

#### ツール名：Replace V1

* ツール概要
  * 高度なオプションを使用して正規表現パターンを使用してテキストを検索および置換します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * 統計情報とメタデータを含む置換結果
* 使用例
  * 単純なテキスト置換
    * replace\_v1("tmpfs\://docs/readme.txt", "TODO", "COMPLETED")
  * グループキャプチャを使用した大文字と小文字を区別しない置換
    * replace\_v1("tmpfs\://code/main.py", "function\s+(\w+)", "def $1", case\_insensitive=True)
  * 複数行にまたがる置換
    * replace\_v1("tmpfs\://docs/guide.md", "old section.\*?end section", "new content", multiline=True)
  * テスト用の限定的な置換
    * replace\_v1("tmpfs\://data/large\_file.csv", "old,value", "new,value", max\_replacements=5)
  * 不要なコンテンツを削除
    * replace\_v1("tmpfs\://logs/debug.log", "DEBUG:.\*", "")

| 設定項目              | 内容                                                                                                  |
| ----------------- | --------------------------------------------------------------------------------------------------- |
| tmpfs             | tmpfs\:// は変更するファイルへのパスです。テキスト読み取り可能なファイル形式であれば何でもサポートされます。                                         |
| pattern           | 検索と置換のための正規表現パターン                                                                                   |
| replacement       | 一致した文字列を置換する文字列                                                                                     |
| multiline         | 複数行検索モードを有効にします。行の境界をまたいでパターンを一致させることができます。複数行または複数セクションにまたがるコンテンツを検索して置換したい場合に使用します。デフォルトはFalseです。 |
| case\_insensitive | 大文字と小文字を区別しない置換を実行します。デフォルトは False です。                                                              |
| max\_replacements | 置換する最大回数（0の場合は無制限）。安全性やテストのために変更を制限する場合に使用します。                                                      |

#### ツール名：Csvkit V1

* ツール概要
  * データの分析と操作のために、CSV ファイルに対して csvkit コマンドを直接実行します。

| 設定項目         | 説明                                                                                                                                  |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| command      | 実行するcsvkitコマンド。                                                                                                                     |
| tmpfs        | 入力ファイルへのパス（tmpfs\://、HTTP/HTTPS URL、または通常のパス）。in2csvの場合：.xlsx、.xls、.json、.ndjson、.geojson、.dbf、固定長ファイルをサポートします。その他のコマンドの場合：CSVファイル。 |
| args         | csvkitコマンドのコマンドライン引数。                                                                                                               |
| output\_path | 出力ファイルのパス（オプション）。指定されていない場合は、tmpfsパスが自動的に生成されます。情報のみを表示するコマンド（csvstat、csvlook）には適用されません。                                            |

#### ツール名：Convert V1

* ツール概要
  * 柔軟な入出力サポートを備えたユニバーサル ファイル形式コンバーター。

| 設定項目            | 内容                                                                                                                                                                    |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| tmpfs           | tmpfs\:// は変換するファイルへのパスです。                                                                                                                                            |
| output\_format  | 出力形式です。                                                                                                                                                               |
| reference\_docx | MDからDOCXへの変換時にスタイルを設定するための参照DOCXファイルへのtmpfs\://パス（省略可）です。この参照ドキュメントには、フォント、スタイル、ヘッダー、ページレイアウトなどの書式設定テンプレートが用意されています。MarkdownからDOCXへの変換にのみ使用されます。                      |
| template        | MDからPDFへの変換時に、オプションのtmpfs\://パスでPandocテンプレートファイルを指定します。テンプレートは、PDF出力時のドキュメントのレイアウト、スタイル、フォーマットを制御します。LaTeXテンプレートおよびその他のPandoc互換形式をサポートします。MarkdownからPDFへの変換にのみ使用されます。 |

#### ツール名：Get Presigned Url V1

* ツール概要
  * tmpfs ファイルをユーザーと共有するためのダウンロード可能な URL を生成します。
* 入出力（引数と戻り値）
  * 戻り値（出力）: メタデータ付きの署名済み URL 情報

| 設定項目        | 説明                                         |
| ----------- | ------------------------------------------ |
| tmpfs       | tmpfsファイルへのパス（tmpfs\://タイムスタンプ/ファイル名形式）。   |
| expires\_in | URLの有効期限（秒）。デフォルト：3600（1時間）。最大：604800（7日間） |

#### ツール名：Extract Ast From Pptx V1

* ツール概要
  * PPTX ファイルから AST (抽象構文ツリー) を抽出します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * AST構造と処理後のtmpfsパスが含まれます
      * ast: 図形とコンテンツを含むスライド配列を含むプレゼンテーションAST
      * tmpfs\_path: 後続の操作のための処理済みファイルへのパス
      * filename: 元のファイル名

| 設定項目  | 説明                                                                           |
| ----- | ---------------------------------------------------------------------------- |
| tmpfs | PPTXファイルへのtmpfsパス（必須）。ダウンロードツールから取得したtmpfs\://path/to/file.pptx形式である必要があります。 |

#### ツール名：Build Pptx From Ast V1

* ツール概要
  * AST (抽象構文ツリー) 構造から PPTX ファイルを構築します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * 成功ステータスとファイル情報
      * success: 操作の成功を示すブール値
      * tmpfs\_path: 作成されたPPTXファイルへのパス
      * filename: 作成されたPPTXファイル名

| 設定項目           | 説明                                                                                                                                                                                                                                                    |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| tmpfs          | PPTXファイルが作成されるtmpfsパス（必須）。tmpfs\://path/to/file.pptx 形式である必要があります。                                                                                                                                                                                    |
| ast            | プレゼンテーションを表すAST構造（必須）。スライド、図形、コンテンツを含むPresentationModelスキーマに従う必要があります。AST構造の重要なルール： - 'paragraphs'配列には段落オブジェクト（'runs'フィールドを持つ辞書）のみを含める必要があります。 - 'runs'配列には、'text'フィールドを持つ辞書のみを含める必要があります。 - text\_frameまたは段落内に図形レベルのフィールド（'rotation'など）を混在させないでください。 |
| template\_pptx | ベースとして使用するオプションのPPTXテンプレート。(1) 組み込みテンプレート名（使用可能なテンプレートを確認するにはget\_pptx\_template\_list\_v1()を使用してください）、または(2) tmpfsパス（'tmpfs\://path/to/template.pptx'など）のいずれかを指定できます。指定すると、スライドはこのテンプレートのレイアウトを使用し、元のデザイン（フォント、色、マスタースライド）は保持されます。                   |

#### ツール名：Get Pptx Template List V1

* ツール概要
  * 利用可能な PPTX スライド テンプレートのリストを取得します。

#### ツール名：Get Pptx Template Ast V1

* ツール概要
  * 特定の PPTX テンプレートの AST 構造を取得します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * テンプレートASTと包括的なメタデータが含まれます。
      * success: 操作の成功を示すブール値
      * name: テンプレート名
      * description: テンプレートの説明と目的
      * pptx\_template: 推奨されるPPTXテンプレート（汎用テンプレートの場合はnull）
      * finalize\_deck\_v1 で適切なスタイルを設定すると有効になります。
      * ast: テンプレートの完全なAST構造
      * metadata: テンプレート情報（テンプレートの種類によって構造が異なります）
      * components: コンポーネントの説明とプレースホルダー
      * style: スタイル識別子
      * language: 対象言語（例: 'ja'、'en'、'ko'）

| 設定項目 | 説明                                                                          |
| ---- | --------------------------------------------------------------------------- |
| name | 取得するテンプレート名（必須）。利用可能なテンプレートを確認するには、get\_pptx\_template\_list\_v1 を使用してください。 |

#### ツール名：Create New Deck V1

* ツール概要
  * 新しいプレゼンテーション デッキを作成し、一意のデッキ ID を返します。

#### ツール名：Add Ast To Deck V1

* ツール概要
  * 既存のデッキに 1 つ以上のスライド AST を追加します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * 更新ステータスが含まれます
      * success: 操作の成功を示すブール値
      * deck\_id: 更新されたデッキのID
      * total\_slides: デッキ内の現在のスライド数
      * slides\_added: 追加されたスライド番号のリスト (例: \[0, 1, 2])
      * slides\_count: この操作で追加されたスライドの数

| 設定項目       | 内容                                                |
| ---------- | ------------------------------------------------- |
| deck\_id   | スライドを追加するデッキID（必須）。create\_new\_deck\_v1から取得されます。 |
| slide\_ast | 追加するスライドのASTデータ（必須）。                              |

#### ツール名：Finalize Deck V1

* ツール概要
  * デッキを完成させ、PPTX ファイルを生成します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * ファイナライズ結果が含まれます
      * success: 操作の成功を示すブール値
      * deck\_id: ファイナライズされたデッキID
      * total\_slides: プレゼンテーションのスライド数
      * tmpfs\_path: 生成されたPPTXファイルへのパス
      * filename: 生成されたPPTXファイル名

| 設定項目           | 内容                                           |
| -------------- | -------------------------------------------- |
| deck\_id       | 確定するデッキID（必須）。create\_new\_deck\_v1から取得されます。 |
| template\_pptx | ベースとして使用するオプションのPPTXテンプレート。                  |

### Allganize Sample Test MCP Server <a href="#agent-creation" id="agent-creation"></a>

**概要**

開発およびテスト用のMCP Serverを例示構成でテストをする

#### ツール名：Echo With Config

* ツール概要
  * 入力テキストとすべての設定変数をそのまま返す（Echoする）機能
* 利用例
  * 「会社の方針」に関するすべての文書を探す
  * 特定のハッシュタグが付けられた文書を検索する
  * 特定の条件に一致する文書を見つける
* 入出力（引数と戻り値）
  * 引数（入力）：
    * input\_text: 返却する任意のテキスト文字列
  * 戻り値（出力）:&#x20;
    * 入力テキストと、すべての設定変数を含む結果
* 入力例
  * 「input」: 「hello」「timestamp」: 「2025-01-01T12:00:00Z」, 「credentials」: { 「api\_url」: 「<https://api.allganize.ai」>, 『api\_key』: 「ASDF...」, 「project\_id」: 「proj-123」, 「agent\_email」: 「<agent@example.com>」 }, 「example\_vars」: { 「example1」: 「foo」, 「example2」: 「bar」, 「example3」: 「baz」, 『example4』: 「qux」 }&#x20;

#### ツール名：Time Sleep

* ツール概要
  * 指定した秒数だけスリープし、タイミング情報を返す機能
* 利用例
  * 「会社の方針」に関するすべての文書を探す
  * 特定のハッシュタグが付けられた文書を検索する
  * 特定の条件に一致する文書を見つける
* 入出力（引数と戻り値）
  * 引数（入力）：
    * スリープする秒数（正の整数である必要があります）
  * 戻り値（出力）:&#x20;
    * 入力時刻、スリープ時間、終了時刻などのタイミング情報を含む辞書
* 入力例
  * "input\_seconds": 5, "start\_time": "2025-01-07T10:30:00.123456", "end\_time": "2025-01-07T10:30:05.125678", "actual\_sleep\_seconds": 5.002222, "message": "Slept for 5 seconds (actual: 5.002222s)"&#x20;

### Box MCP Server <a href="#agent-creation" id="agent-creation"></a>

**概要**

Box API と OAuth 認証を統合した MCP サーバーにより、Boxのファイルおよびフォルダー管理、共有、共同作業機能が有効になります。

| 設定項目                 | 説明                                               |
| -------------------- | ------------------------------------------------ |
| ALLI\_API\_URL       | AlliのAPI接続URL（設定例：<https://backend.alli.ai/api>） |
| ALLI\_API\_KEY       | AlliのAPIキー（設定例：US1XJA）                           |
| ALLI\_PROJECT\_ID    | AlliのプロジェクトID（設定例：UHJvamV）                       |
| ALLI\_AGENT\_EMAIL   | Alliのアカウントemailアドレス（設定例：<lli@alli.ai>）           |
| OAuth 2.0 Client ID  | 「boxと連携」ボタンから、 Boxアカウントと連携します                    |

#### ツール名：Box Upload File

* ツール概要
  * tmpfs から Box にファイルをアップロードします
* 戻り値（出力）:&#x20;
  * ID、名前、サイズ、作成タイムスタンプなどのアップロードされたファイルの情報を含む辞書。

| 設定項目               | 説明                                                            |
| ------------------ | ------------------------------------------------------------- |
| tmpfs\_path        | アップロードするファイルの tmpfs パス（設定例：tmpfs\://20240101120000/hello.txt） |
| file\_name         | ファイル名（設定例：hello.txt）                                          |
| parent\_folder\_id | 親フォルダの ID （ルートフォルダには「0」を使用します）（設定例：0,123456789）               |

#### ツール名：Box Download File

* ツール概要
  * Box から tmpfs にファイルをダウンロードします
* 戻り値（出力）:&#x20;
  * tmpfs\_path: ファイルが保存されているtmpfsパス
  * filename: 元のファイル名
  * file\_size\_bytes: ファイルサイズ（バイト単位）
  * metadata: ファイル情報（ID、名前、サイズなど

| 設定項目     | 説明                              |
| -------- | ------------------------------- |
| file\_id | ダウンロードするファイルの ID（設定例：123456789） |

#### ツール名：Box Update File

* ツール概要
  * tmpfs から Box のファイルを更新します。
* 戻り値（出力）:&#x20;
  * 更新されたファイル情報を含む辞書。

| 設定項目        | 説明                                                                |
| ----------- | ----------------------------------------------------------------- |
| file\_id    | アップデートするファイルの ID（設定例：123456789）                                   |
| tmpfs\_path | 更新するファイルの tmpfs パス（設定例：tmpfs\://20240101120000/updated\_file.txt） |

#### ツール名：Box Delete File

* ツール概要
  * Boxからファイルを削除します
* 戻り値（出力）:&#x20;
  * 削除が成功したことを示す辞書。

| 設定項目     | 説明                          |
| -------- | --------------------------- |
| file\_id | 削除するファイルの ID（設定例：123456789） |

#### ツール名：Box Get File Info

* ツール概要
  * Boxにあるファイルの詳細情報を取得します
* 戻り値（出力）:&#x20;
  * ID、名前、サイズ、作成日/更新日、親フォルダなどのファイルメタデータを含む辞書。

| 設定項目     | 説明                               |
| -------- | -------------------------------- |
| file\_id | 詳細情報を取得するファイルの ID（設定例：123456789） |

#### ツール名：Box Copy File

* ツール概要
  * Boxにあるファイルを別のフォルダにコピーします。
* 戻り値（出力）:&#x20;
  * コピーされたファイルの情報を含む辞書。

| 設定項目               | 説明                                       |
| ------------------ | ---------------------------------------- |
| file\_id           | コピーするファイルの ID（設定例：123456789）             |
| parent\_folder\_id | コピー先フォルダのID（設定例：987654321）               |
| new\_name          | コピーされたファイルの新しい名前（設定例：copy\_of\_file.txt） |

#### ツール名：Box Move File

* ツール概要
  * 移動されたファイルの情報を含む辞書。
* 戻り値（出力）:&#x20;
  * コピーされたファイルの情報を含む辞書。

| 設定項目               | 説明                                |
| ------------------ | --------------------------------- |
| file\_id           | 移動するファイルの ID（設定例：123456789）       |
| parent\_folder\_id | 移動先のフォルダのID（設定例：987654321）        |
| new\_name          | ファイルの新しい名前（設定例：renamed\_file.txt） |

#### ツール名：Box Create Folder

* ツール概要
  * Box に新しいフォルダを作成します。
* 戻り値（出力）:&#x20;
  * 作成されたフォルダのIDと名前を含む辞書型データ。

| 設定項目               | 説明                                            |
| ------------------ | --------------------------------------------- |
| folder\_name       | 作成するフォルダの名前（設定例：New Folder）                   |
| parent\_folder\_id | 親フォルダのID (ルートフォルダの場合は '0' を使用)（設定例：123456789） |

#### ツール名：Box List Folder Items

* ツール概要
  * Boxのフォルダ内のアイテムを一覧表示します。
* 戻り値（出力）:&#x20;
  * 以下の内容を含む辞書
    * entries: ファイルとフォルダのリスト
    * total\_count: アイテムの総数
    * limit: 1ページあたりのアイテム数
    * offset: 現在のオフセット

| 設定項目       | 説明                                 |
| ---------- | ---------------------------------- |
| folder\_id | 詳細情報を取得するフォルダのID（設定例：123456789）    |
| limit      | 取得する詳細情報のアイテムの最大数(最大 1000)（設定例：50） |
| offset     | 取得する詳細情報のアイテムの開始オフセット（設定例：50）      |

#### ツール名：Box Get Folder Info

* ツール概要
  * Boxのフォルダの詳細情報を取得します。
* 戻り値（出力）:&#x20;
  * フォルダのメタデータ（ID、名前、サイズ、アイテム数、親フォルダなど）を含む辞書型データ。

| 設定項目       | 説明                              |
| ---------- | ------------------------------- |
| folder\_id | 詳細情報を取得するフォルダのID（設定例：123456789） |

#### ツール名：Box Delete Folder

* ツール概要
  * Boxからフォルダを削除します。
* 戻り値（出力）:&#x20;
  * 削除が成功したことを示す辞書。

| 設定項目       | 説明                                                              |
| ---------- | --------------------------------------------------------------- |
| folder\_id | 削除するフォルダのID（設定例：123456789）                                      |
| recursive  | <p>フォルダ内にアイテムが含まれている場合、削除を許可するか<br>(許可する=True, 許可しない=False)</p> |

#### ツール名：Box Copy Folder

* ツール概要
  * Boxのフォルダを別の場所にコピーします。
* 戻り値（出力）:&#x20;
  * コピーされたフォルダの情報を含む辞書。

| 設定項目               | 説明                                                              |
| ------------------ | --------------------------------------------------------------- |
| recursive          | <p>フォルダ内にアイテムが含まれている場合、削除を許可するか<br>(許可する=True, 許可しない=False)</p> |
| folder\_id         | コピーするフォルダのID（設定例：123456789）                                     |
| parent\_folder\_id | コピー先の親フォルダのID（設定例：987654321）                                    |

#### ツール名：Box Move Folder

* ツール概要
  * Boxのフォルダを別の場所に移動します。
* 戻り値（出力）:&#x20;
  * 移動されたフォルダの情報を含む辞書。

| 設定項目               | 説明                          |
| ------------------ | --------------------------- |
| folder\_id         | 移動するフォルダのID（設定例：123456789   |
| parent\_folder\_id | 移動先の親フォルダのID（設定例：987654321） |

#### ツール名：Box Search

* ツール概要
  * Box内のファイルとフォルダを検索します。
* 戻り値（出力）:&#x20;
  * 以下の項目を含む辞書:
    * entries: 一致する項目のリスト
    * total\_count: 一致する項目の総数
    * limit: 1ページあたりの項目数
    * offset: 現在のオフセット

| 設定項目                  | 説明                                         |
| --------------------- | ------------------------------------------ |
| query                 | 検索クエリ（設定例：quarterly report）                |
| file\_extensions      | フィルタリングするファイル拡張子のリスト（例：\['pdf', 'docx']）   |
| type                  | 検索対象アイテムの種類：'file'、'folder'、または'web\_link' |
| ancestor\_folder\_ids | 検索対象となるフォルダIDのリスト（設定例：123456789）           |
| limit                 | 返されるアイテムの最大数（最大200個）（設定例：10）               |
| offset                | 返されるアイテムの開始オフセット（設定例：10）                   |

#### ツール名：Box Create Shared Link

* ツール概要
  * Boxのファイルまたはフォルダの共有リンクを作成します。
* 戻り値（出力）:&#x20;
  * 共有リンクのURLと設定を含む辞書。

| 設定項目          | 説明                                                     |
| ------------- | ------------------------------------------------------ |
| item\_type    | アイテムの種類（ 'file' または 'folder'）                          |
| item\_id      | アイテムのID（設定例：123456789）                                 |
| access        | <p>アクセスレベル<br>（ 'open','company', 'collaborators'）</p> |
| password      | 共有リンクのパスワード（設定例：secret123）                             |
| unshared\_at  | リンクの有効期限を示すISO 8601タイムスタンプ（設定例：2025-12-31T23:59:59Z）   |
| can\_download | <p>共有リンクでのダウンロードを許可するか<br>(許可する=True, 許可しない=False)</p> |

#### ツール名：Box Get Shared Link

* ツール概要
  * ファイルまたはフォルダの共有リンク情報を取得します。
* 戻り値（出力）:&#x20;
  * 共有リンクのURLと設定を含む辞書、またはリンクが存在しない場合はメッセージ。

| 設定項目          | 説明                                                     |
| ------------- | ------------------------------------------------------ |
| can\_download | <p>共有リンクでのダウンロードを許可するか<br>(許可する=True, 許可しない=False)</p> |
| item\_type    | アイテムの種類（ 'file' または 'folder'）                          |
| item\_id      | アイテムのID（設定例：123456789）                                 |

#### ツール名：Box Delete Shared Link

* ツール概要
  * ファイルまたはフォルダから共有リンクを削除します。
* 戻り値（出力）:&#x20;
  * 削除が成功したことを示す辞書。

| 設定項目       | 説明                            |
| ---------- | ----------------------------- |
| item\_type | アイテムの種類（ 'file' または 'folder'） |
| item\_id   | アイテムのID（設定例：123456789）        |

### DOCX Template MCP Server <a href="#agent-creation" id="agent-creation"></a>

**概要**

エージェントがDocxテンプレートとやり取りできるようにする、DocxテンプレートAPI用MCPサーバー

#### ツール名：Get Docx Template Parameters

* ツール概要
  * docxファイル（ファイルパス）の全パラメータ情報を取得する
* 利用例
  * 「会社の方針」に関するすべての文書を探す
  * 特定のハッシュタグが付けられた文書を検索する
  * 特定の条件に一致する文書を見つける
* 入出力（引数と戻り値）
  * 引数（入力）：
    * template\_path (str): docx テンプレートファイルのパス
  * 戻り値（出力）:&#x20;
    * str: パラメータ情報およびその例示

#### ツール名：Generate Docx From Template

* ツール概要
  * テンプレートパスからパラメータ付きでdocxファイルを生成する
* 利用例
  * 「会社の方針」に関するすべての文書を探す
  * 特定のハッシュタグが付けられた文書を検索する
  * 特定の条件に一致する文書を見つける
* 入出力（引数と戻り値）
  * 引数（入力）：
    * template\_path (str): docxテンプレートファイルのパス
    * output\_file\_name (str): 出力docxファイル名。末尾は.docxでなければならない
    * parameters (dict\[str, Any]): docxテンプレートのパラメータ。この辞書のキーとget\_docx\_template\_parametersの出力に対応している必要がある。
  * 戻り値（出力）:&#x20;
    * str: 生成されたdocxファイルの事前署名済みURL。

| 設定値                |                                                                           |
| ------------------ | ------------------------------------------------------------------------- |
| template\_path     | docxテンプレートファイルのパス                                                         |
| output\_file\_name | 出力docxファイル名。末尾は.docxでなければならない                                             |
| parameters         | docxテンプレートのパラメータ。この辞書のキーとはget\_docx\_template\_parametersの出力に対応している必要がある。 |

#### ツール名：Generate Excel From Template

* ツール概要
  * テンプレートに一連の操作を適用して Excel ファイルを生成する。
* 入出力（引数と戻り値）
  * 引数（入力）：
    * template\_path (str): Excel テンプレートファイルのパス（必須）
    * output\_file\_name (str): 出力する Excel ファイル名（.excel で終わっている必要があります・必須）
    * operations (dict\[str, Any]): Excel テンプレートに対して行う操作（必須）
  * 戻り値（出力）:&#x20;
    * str: 生成されたdocxファイルの事前署名済みURL。

| 設定項目               | 説明                                         |
| ------------------ | ------------------------------------------ |
| template\_path     | Excel テンプレートファイルのパス（必須）                    |
| output\_file\_name | 出力する Excel ファイル名（.excel で終わっている必要があります・必須） |
| operations         | Excel テンプレートに対して行う操作（必須）                   |

### Everything <a href="#agent-creation" id="agent-creation"></a>

**概要**

このMCPサーバは、MCPプロトコルの全機能の実装を試みます。

#### ツール名：echo

* ツール概要
  * 入力内容を反復する

| 設定項目    | 説明                   |
| ------- | -------------------- |
| message | エコー（そのまま返す）対象のメッセージ。 |

#### ツール名：add

* ツール概要
  * 2つの数を加算する

| 設定項目 | 説明    |
| ---- | ----- |
| a    | 最初の数字 |
| b    | 次の数字  |

#### ツール名：printEnv

* ツール概要
  * すべての環境変数を出力します。MCPサーバーの設定のデバッグに役立ちます。

#### ツール名：longRunningOperation

* ツール概要
  * 長時間実行される操作を、進行状況の更新とともに表示する

| 設定項目     | 説明           |
| -------- | ------------ |
| duration | 操作の所要時間（秒単位） |
| steps    | 操作のステップ数     |

#### ツール名：sampleLLM

* ツール概要
  * MCPのサンプリング機能を使用したLLMのサンプル

| 設定項目      | 説明            |
| --------- | ------------- |
| prompt    | LLMに送信するプロンプト |
| maxTokens | 生成するトークンの最大数  |

#### ツール名：getTinyImage

* ツール概要
  * MCP\_TINY\_IMAGE を返します

### Fetch <a href="#agent-creation" id="agent-creation"></a>

**概要**

Web コンテンツの取得機能を提供するMCPサーバー

#### ツール名：fetch

* ツール概要
  * URLからインターネット上の情報を取得し、オプションでその内容をMarkdownとして抽出します。\
    最新の情報を取得し、ユーザーにその旨を伝えることができます。

| 設定項目         | 説明                                                                         |
| ------------ | -------------------------------------------------------------------------- |
| url          | コンテンツを取得するURL                                                              |
| max\_length  | レスポンスとして取得する文字数の最大値。                                                       |
| start\_index | <p>レスポンスの際に、この文字インデックス以降のコンテンツを取得します。<br>必要なデータのみをContextに含めたい場合に有効です。</p> |
| raw          | リクエストされたWebページの実際の HTMLコンテンツを簡略化せずに取得します。                                  |

### Image Creation MCP Server <a href="#agent-creation" id="agent-creation"></a>

**概要**

SERVERLESS API または OpenAI API を使用して、AI画像を生成する MCP サーバー。\
生成された画像はAlliのプロジェクト内のファイルストレージに自動的にアップロードされ、シームレスな画像アクセスを実現します。

| 設定項目     | 説明                                                                                        |
| -------- | ----------------------------------------------------------------------------------------- |
| PROVIDER | 画像生成のプロバイダータイプ（SERVERLESS または OPENAI）                                                     |
| API\_KEY | 選択したプロバイダーの API キー (SERVERLESS API キーまたは OpenAI API キー)                                   |
| ENDPOINT | プロバイダーエンドポイント (SERVERLESS エンドポイント ID または OpenAI ベース URL (<https://api.openai.com/v1> など)) |
| MODEL    | モデル名（dall-e-3 などの OpenAI では必須ですが、SERVERLESS の場合は必要ありません）                                  |

#### ツール名：Create Image

* ツール概要
  * SERVERLESS API または OpenAI API を使用して画像を作成し、Alli にアップロードします。このツールは以下の処理を行います。
    1. SERVERLESS API または OpenAI API に画像生成リクエストを送信します。
    2. 完了ステータスをポーリングします。
    3. 生成された画像（base64 形式）をダウンロードします。
    4. upload\_media API を使用して、Alli にアップロードします。
    5. 画像にアクセスするためのメディア URL を返します。
* 入出力（引数と戻り値）
  * 引数（入力）：
    * template\_path (str): docxテンプレートファイルのパス
    * output\_file\_name (str): 出力docxファイル名。末尾は.docxでなければならない
    * parameters (dict\[str, Any]): docxテンプレートのパラメータ。この辞書のキーとget\_docx\_template\_parametersの出力に対応している必要がある。
  * 戻り値（出力）:&#x20;
    * str: 生成されたdocxファイルの事前署名済みURL。
* 入力例
  * シンプルな画像: create\_image("月明かりの下を歩く黒猫")
  * 詳細な画像: create\_image("ゴールデンレトリバーのリアルなポートレート", size="1024x1024", quality="high", style="vivid", response\_format="b64\_json", num\_inference\_steps=50)

| 設定項目                  | 説明                                                                                                                                                                                                                       |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| prompt                | <p>生成する画像を説明するテキストプロンプトです。英語で記述する必要があります。画質を向上させるために、詳細かつ具体的な説明を記入してください。アートスタイル、照明、構図、色、雰囲気、技術的な詳細などを具体的に指定してください。</p><p>例：「太陽の光が差し込む庭に座るゴールデンレトリバーの写実的なポートレート。柔らかな自然光、浅い被写界深度、温かみのあるゴールデンアワーの雰囲気、プロフェッショナルな撮影スタイル」</p> |
| size                  | <p>生成する画像のサイズ。次のいずれかを指定する必要があります: 256x256、512x512、1024x1024、1536x1024、1024x1536、1792x1024、1024x1792 (デフォルト)。<br>OpenAI APIでのみ使用されます。</p>                                                                                 |
| quality               | <p>生成する画像の品質。以下のいずれかを指定する必要があります：high、medium、low、hd、standard（デフォルト）。<br>OpenAI API でのみ使用されます。</p>                                                                                                                        |
| style                 | <p>生成する画像のスタイル。以下のいずれかを指定する必要があります：vivid、natural（デフォルト）。<br>OpenAI API でのみ使用されます。</p>                                                                                                                                    |
| response\_format      | <p>生成する画像のフォーマット。以下のいずれかを指定する必要があります：url、b64\_json（デフォルト）。<br>OpenAI API でのみ使用されます。</p>                                                                                                                                  |
| num\_inference\_steps | <p>画像生成の推論ステップ数（デフォルト）。<br>SERVERLESS API でのみ使用されます。</p>                                                                                                                                                                 |

### OpenAI Tools <a href="#agent-creation" id="agent-creation"></a>

**概要**

音声認識 (Whisper)、音声翻訳、画像生成 (DALL-E) などの OpenAI API を提供する MCP サーバーです。

| 設定項目               | 説明                                                                          |
| ------------------ | --------------------------------------------------------------------------- |
| OPENAI\_API\_KEY   | OpenAI APIキー。環境変数を参照するには「ENV\_VARIABLE\_NAME」を使用します（例：ENV\_MY\_OPENAI\_KEY） |
| ALLI\_API\_KEY     | AlliのAPIキー                                                                  |
| ALLI\_API\_URL     | AlliのAPI接続URL                                                               |
| ALLI\_AGENT\_EMAIL | Alliのアカウントemailアドレス                                                         |
| ALLI\_PROJECT\_ID  | AlliのプロジェクトID                                                               |

#### ツール名：Transcribe Audio

* ツール概要
  * OpenAI Whisper API を使用して音声ファイルをテキストに変換します。テキストの説明からAI生成画像を作成し、一時ストレージに保存します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * 以下の要素を含む辞書
      * images: 'tmpfs\_path' とオプションで 'revised\_prompt' を持つ画像オブジェクトのリスト
      * model: 生成に使用したモデル
      * size: 画像のサイズ
      * count: 生成した画像の数
* 入力例
  * generate\_image("A serene Japanese garden at sunset", model="dall-e-3", quality="hd") -> { "images": \[{"tmpfs\_path": "tmpfs\://20250115123456/A\_serene\_Japanese\_garden\_at\_sunset\_1.png", "revised\_prompt": "..."}], "model": "dall-e-3", "size": "1024x1024", "count": 1 }

| 設定項目        | 説明                                                                                                                                                         |
| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| file\_path  | 文字起こしする音声ファイル。HTTP/HTTPS URL、tmpfsパス（tmpfs\://...）、またはファイル名で指定できます。GPT-4oモデル：wav、mp3のみ（最大10MB）。Whisper：flac、m4a、mp3、mp4、mpeg、mpga、oga、ogg、wav、webm（最大25MB） |
| model       | 使用するモデル: 'gpt-4o-audio-preview' (音声付き GPT-4o)、 'gpt-4o-mini-audio-preview' (小さい GPT-4o 音声)、 'whisper-1' (標準 Whisper)                                       |
| language    | オプション：ISO-639-1言語コード（例：'en'、'ko'、'ja'、'es'、'fr'、'de'、'zh'）。指定されていない場合、Whisperは言語を自動検出します。これは、未知の音声の場合に推奨されます。事前に言語がわかっている場合は、指定することで精度が向上します。              |
| prompt      | モデルのスタイルをガイドするオプションのテキスト。名前、専門用語、または文脈の正しいスペルを含めることができます。例：「これは、Acme Inc.の製品発表に関する、CEOのスミス博士との会議です。」                                                       |
| temperature | サンプリングのTemperature（0～1）。値が大きいほどランダム性が増す。                                                                                                                   |

#### ツール名：Text To Speech

* ツール概要
  * OpenAI TTS API を使用してテキストを音声に変換し、tmpfs に保存します。複数の音声と形式で入力されたテキストから自然な音声を作成します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * 以下の要素を含む辞書
      * tmpfs\_path: tmpfs 内の生成された音声ファイルへのパス
      * voice: 生成に使用した音声
      * model: 使用したモデル
      * format: 音声形式
      * duration\_estimate: テキストの長さに基づく推定再生時間
* 入力例
  * text\_to\_speech("Hello world!", voice="nova") -> { "tmpfs\_path": "tmpfs\://20250115123456/speech\_nova\_1.mp3", "voice": "nova", "model": "tts-1", "format": "mp3", "duration\_estimate": "\~2 seconds" }

| 設定項目             | 説明                                                      |
| ---------------- | ------------------------------------------------------- |
| text             | 音声に変換するテキスト。最大4096文字。                                   |
| voice            | 使用する音声。オプション: 「alloy」「echo」「fable」「onyx」「nova」「shimmer」 |
| model            | TTS モデル。「tts-1」（高速、低品質）または「tts-1-hd」（低速、高品質）            |
| speed            | 話す速度（0.25～4.0）。1.0 が通常の速度です。                            |
| response\_format | オーディオ形式。オプション: 'mp3'、'opus'、'aac'、'flac'、'wav'、'pcm'    |

#### ツール名：Generate Image

* ツール概要
  * OpenAI DALL-E API を使用してイメージを生成し、tmpfs に保存します。テキストの説明からAI生成画像を作成し、一時ストレージに保存します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * 以下の要素を含む辞書
      * images: 'tmpfs\_path' とオプションで 'revised\_prompt' を持つ画像オブジェクトのリスト
      * model: 生成に使用したモデル
      * size: 画像のサイズ
      * count: 生成した画像の数
* 入力例
  * generate\_image("A serene Japanese garden at sunset", model="dall-e-3", quality="hd") -> { "images": \[{"tmpfs\_path": "tmpfs\://20250115123456/A\_serene\_Japanese\_garden\_at\_sunset\_1.png", "revised\_prompt": "..."}], "model": "dall-e-3", "size": "1024x1024", "count": 1 }

| 詳細項目    | 説明                                                                                            |
| ------- | --------------------------------------------------------------------------------------------- |
| prompt  | 生成する画像の説明文です。具体的かつ詳細な説明を記述することで、最良の結果が得られます。                                                  |
| model   | 使用するモデル: 「dall-e-3」(最新、最高品質) または「dall-e-2」(より高速、安価)                                           |
| size    | 画像サイズ。DALL-E 3: '1024x1024'、'1024x1792'、'1792x1024'。DALL-E 2: '256x256'、'512x512'、'1024x1024' |
| quality | 画像品質（DALL-E 3 のみ）: 「標準」または「HD」（高画質、詳細）                                                        |
| style   | 画像スタイル（DALL-E 3 のみ）: 「鮮明」（ハイパーリアル）または「ナチュラル」（より自然）                                            |
| n       | 生成する画像の数（DALL-E 2の場合は1～10、DALL-E 3の場合は1のみ）                                                    |

### Run Python <a href="#agent-creation" id="agent-creation"></a>

**概要**

Python 実行機能を提供するMCPサーバーです。

#### ツール名：run\_python\_code

* ツール概要
  * Python コードを実行し、標準出力、標準エラー出力、戻り値を返すツールです。コードは非同期で実行でき、最終行の値が戻り値として返されます。

    コードは Python 3.12 で実行されます。

    依存関係は PEP 723 スクリプトメタデータで定義できます。例えば、「pydantic」をインストールする場合、スクリプトは以下の形式のコメントで始まる必要があります。

    /// script\
    dependencies = \['pydantic']\
    ///\
    print('python code here')

### SERPER API MCP Server <a href="#agent-creation" id="agent-creation"></a>

**概要**

SERPER API (serper.dev) 用の MCP サーバー。Web、画像、ニュース、動画、ショッピング、場所、学者検索などの包括的な Google 検索機能を提供します。

| 設定項目              | 説明                                   |
| ----------------- | ------------------------------------ |
| SERPER\_API\_KEY  | Google 検索サービスにアクセスするためのSERPER API キー |

#### ツール名：Search Web

* ツール概要
  * SERPER API (Google 検索) を使用してウェブ検索を実行します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * 以下の要素を含む辞書
      * organic: タイトル、リンク、スニペットを含むオーガニック検索結果のリスト
      * knowledgeGraph: ナレッジグラフ情報 (利用可能な場合)
      * answerBox: 回答ボックスの内容 (利用可能な場合)
      * relatedSearches: 関連検索候補
      * searchParameters: 実行された検索に関する情報
* 入力例
  * search\_web("python programming", num=5) -> { "organic": \[ {"title": "Python.org", "link": "<https://python.org>", "snippet": "Official Python website..."}, ... ], "knowledgeGraph": {...}, "answerBox": {...}, "relatedSearches": \[{"query": "python tutorial"}, ...] }

| 設定項目        | 説明                          |
| ----------- | --------------------------- |
| query       | 検索クエリ文字列                    |
| num         | 返却される結果の数（デフォルト: 10）        |
| country     | 国コード（例：「us」、「kr」、「jp」）      |
| location    | 検索する場所（例：「ニューヨーク、NY」）       |
| locale      | ロケールコード (例: 「en」、「ko」、「ja」) |
| autocorrect | 検索クエリの自動補完を有効にする            |
| page        | ページ番号（デフォルト：1）              |

#### ツール名：Images

* ツール概要
  * SERPER API を使用して画像を検索します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * 以下の要素を含む辞書
      * images: タイトル、画像URL、画像幅、画像高さ、ソースを含む画像結果のリスト
      * searchParameters: 実行された検索に関する情報
* 入力例
  * search\_images("cute puppies", num=5) -> { "images": \[ { "title": "Adorable Puppy", "imageUrl": "<https://example.com/puppy.jpg>", "imageWidth": 800, "imageHeight": 600, "source": "example.com" }, ... ] }

| 設定項目        | 説明                          |
| ----------- | --------------------------- |
| query       | 検索クエリ文字列                    |
| num         | 返却される結果の数（デフォルト: 10）        |
| country     | 国コード（例：「us」、「kr」、「jp」）      |
| locale      | ロケールコード (例: 「en」、「ko」、「ja」) |
| autocorrect | 検索クエリの自動補完を有効にする            |

#### ツール名：News

* ツール概要
  * SERPER API を使用してニュース記事を検索します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * 以下の要素を含む辞書
      * news: タイトル、リンク、スニペット、日付、ソースを含むニュース記事のリスト
      * searchParameters: 実行された検索に関する情報
* 入力例
  * search\_news("AI breakthrough", tbs="qdr:w") -> { "news": \[ { "title": "AIの大きなブレークスルーが発表されました", "link": "<https://news.example.com/ai-breakthrough>", "snippet": "科学者が発表...", "date": "2日前", "source": "技術ニュース" }, ... ] }

| 設定項目        | 詳細設定                                         |
| ----------- | -------------------------------------------- |
| query       | 検索クエリ文字列                                     |
| num         | 返却される結果の数（デフォルト: 10）                         |
| country     | 国コード（例：「us」、「kr」、「jp」）                       |
| locale      | ロケールコード (例: 「en」、「ko」、「ja」)                  |
| autocorrect | 検索クエリの自動補完を有効にする                             |
| tbs         | 時間ベースの検索（例：過去1日の場合は「qdr:d」、過去1週間の場合は「qdr:w」） |

#### ツール名：Videos

* ツール概要
  * SERPER API を使用して動画を検索します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * 以下の要素を含む辞書
      * videos: タイトル、リンク、スニペット、画像 URL、再生時間、ソースを含む動画のリスト
      * searchParameters: 実行された検索に関する情報
* 入力例
  * search\_videos("machine learning tutorial") -> { "videos": \[ { "title": "ML Tutorial for Beginners", "link": "<https://youtube.com/watch?v=>...", "snippet": "Learn machine learning basics...", "imageUrl": "<https://i.ytimg.com/>...", "duration": "15:30", "source": "YouTube" }, ... ] }

| 設定項目        | 説明                          |
| ----------- | --------------------------- |
| query       | 検索クエリ文字列                    |
| num         | 返却される結果の数（デフォルト: 10）        |
| country     | 国コード（例：「us」、「kr」、「jp」）      |
| locale      | ロケールコード (例: 「en」、「ko」、「ja」) |
| autocorrect | 検索クエリの自動補完を有効にする            |

#### ツール名：Search Shopping

* ツール概要
  * SERPER API を使用して、商品とショッピング結果を検索します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * 以下の要素を含む辞書
      * shopping: タイトル、価格、リンク、ソース、評価、レビューを含む商品リスト
      * searchParameters: 実行された検索に関する情報
* 入力例
  * search\_shopping("laptop") -> { "shopping": \[ { "title": "Dell XPS 13", "price": "$999.99", "link": "<https://shop.example.com/>...", "source": "Dell Store", "rating": 4.5, "reviews": 1250 }, ... ] }

| 設定項目        | 説明                          |
| ----------- | --------------------------- |
| query       | 検索クエリ文字列                    |
| num         | 返却される結果の数（デフォルト: 10）        |
| country     | 国コード（例：「us」、「kr」、「jp」）      |
| locale      | ロケールコード (例: 「en」、「ko」、「ja」) |
| autocorrect | 検索クエリの自動補完を有効にする            |

#### ツール名：Search Places

* ツール概要
  * SERPER API (Google マップ) を使用して場所を検索します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * 以下の要素を含む辞書
      * places: タイトル、住所、評価、レビュー、電話番号、営業時間を含む場所のリスト
      * searchParameters: 実行された検索に関する情報
* 入力例
  * search\_places("coffee shop near Seattle") -> { "places": \[ { "title": "Starbucks Reserve", "address": "1124 Pike St, Seattle, WA", "rating": 4.3, "reviews": 850, "phone": "+1 206-624-0173", "hours": "Open ⋅ Closes 8 PM" }, ... ] }

| 設定項目        | 説明                          |
| ----------- | --------------------------- |
| query       | 検索クエリ文字列                    |
| num         | 返却される結果の数（デフォルト: 10）        |
| country     | 国コード（例：「us」、「kr」、「jp」）      |
| locale      | ロケールコード (例: 「en」、「ko」、「ja」) |
| autocorrect | 検索クエリの自動補完を有効にする            |

#### ツール名：Search Scholar

* ツール概要
  * SERPER API (Google Scholar) を使用して、学術コンテンツを検索します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * 以下の要素を含む辞書
      * organic: タイトル、リンク、スニペット、引用情報を含む学術論文のリスト
      * searchParameters: 実行された検索に関する情報
* 入力例
  * search\_scholar("machine learning algorithms") -> { "organic": \[ { "title": "Deep Learning for Computer Vision", "link": "<https://scholar.google.com/>...", "snippet": "This paper presents...", "citedBy": "Cited by 1250", "publication": "Nature Machine Intelligence" }, ... ] }

| 設定項目        | 説明                          |
| ----------- | --------------------------- |
| query       | 検索クエリ文字列                    |
| num         | 返却される結果の数（デフォルト: 10）        |
| country     | 国コード（例：「us」、「kr」、「jp」）      |
| locale      | ロケールコード (例: 「en」、「ko」、「ja」) |
| autocorrect | 検索クエリの自動補完を有効にする            |

### Salesforce MCP Server <a href="#agent-creation" id="agent-creation"></a>

**概要**

Salesforce APIを統合するためのMCP Serverです。\
Salesforceデータとメタデータとの自然言語によるインタラクションを可能にします。\
オブジェクト検索、スキーマ情報、SOQLクエリ、選択リスト値、リレーションシップ探索、検証ルール、デバッグログ管理が可能です。\
必要なツールを選択してください。

#### ツール名：Search Salesforce Objects

* ツール概要
  * Salesforce の標準オブジェクトとカスタムオブジェクトを名前のパターンで検索します。

    Salesforce オブジェクト（標準またはカスタム）を、名前のパターンで検索して見つけることができます。\
    オブジェクトの正確な名前がわからない場合や、関連オブジェクトを見つけたい場合に有効です。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * Salesforce オブジェクトのフォーマットされたリスト

| 設定項目    | 説明                                     |
| ------- | -------------------------------------- |
| pattern | オブジェクト名に一致する検索パターンを入力（例: 「アカウント」、「注文」） |

#### ツール名：Describe Salesforce Object

* ツール概要
  * Salesforce オブジェクトのすべてのフィールド、リレーションシップ、フィールドプロパティを含む詳細なスキーマメタデータを取得します。
* 使用例
  * 「OpportunityLineItem オブジェクトの構造を説明してください」
  * 「Campaign オブジェクトにはどのようなフィールドがありますか？」
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * オブジェクトの詳細なスキーマ情報
    * 引数で指定したオブジェクトの全フィールド、リレーション、およびプロパティを含む構造データ。

| 設定項目         | 説明                                                           |
| ------------ | ------------------------------------------------------------ |
| object\_name | オブジェクトの API 名 (例: 'Account'、'Contact'、'Custom\_Object\_\_c') |

#### ツール名：Describe Salesforce Object Raw Json

* ツール概要
  * Salesforce オブジェクトスキーマ全体を生の JSON 形式で取得します。
  * Salesforce からフィルタリングされていない API レスポンスが直接返されます。
  * このツールは、高度な分析のために完全かつ詳細なメタデータが必要な場合や、標準の記述形式に含まれていない特定のメタデータプロパティにアクセスする必要がある場合に有効です。
* 使用例
  * リードの生の JSON スキーマを取得する
  * アカウントオブジェクトの完全な API レスポンスを表示する
  * Custom\_Object\_\_c の完全な JSON メタデータを返す
  * 「商談の完全なメタデータスキーマを JSON 形式で取得したい」
  * 「アカウントの技術的なメタデータの詳細をすべて表示する」
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * Salesforce API からの完全な生の JSON スキーマ

| 設定項目         | 説明                                                           |
| ------------ | ------------------------------------------------------------ |
| object\_name | オブジェクトの API 名 (例: 'Account'、'Contact'、'Custom\_Object\_\_c') |

#### ツール名：Get Salesforce Picklist Values

* ツール概要
  * 選択リスト項目からすべての値を取得します。
  * ドロップダウン/選択リスト項目で利用可能なすべてのオプションを返します。
* 使用例
  * すべてのケースステータスの値を取得する
  * Lead.Source の選択リスト値を表示する
  * Account.Type のすべての値を一覧表示する
  * 「取引先で利用可能な業種オプションは何ですか？」
  * 「商談ステージで使用可能なすべての値を表示する」
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * 値のラベル
    * API 名
    * デフォルト値のインジケーター
    * 有効/無効のステータス
    * フィールドの依存関係の制御（存在する場合）

| 設定項目         | 説明                                    |
| ------------ | ------------------------------------- |
| object\_name | オブジェクトの API 名 (例: 'Case'、'Lead')      |
| field\_name  | 選択リスト項目の API 名 (例: 'Status'、'Source') |

#### ツール名：Describe Salesforce Relationship Fields

* ツール概要
  * Salesforce オブジェクトのすべてのリレーションフィールド（参照関係、主従関係）を表示します。オブジェクト間の依存関係と接続を理解するために有効です。
* 使用例
  * 商談のすべての関連オブジェクトを一覧表示する
  * 取引先責任者オブジェクトのリレーションシップを表示する
  * ケースオブジェクトの参照を説明する
  * 「取引先に関連するオブジェクトは何ですか？」
  * 「取引先責任者オブジェクトのすべての参照関係を表示する」
  * 「商談の親子関係は何ですか？」
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * 親子関係
    * 参照関係と主従関係の種類
    * 関連オブジェクト名
    * カスケード削除の動作
    * 必要なリレーションシップのステータス

| 設定項目         | 説明                                         |
| ------------ | ------------------------------------------ |
| object\_name | オブジェクトの API 名 (例: 'Opportunity'、'Contact') |

#### ツール名：Get Salesforce Fields By Type

* ツール概要
  * Salesforce オブジェクトの特定の型のフィールドを取得します。型が指定されていない場合、すべてのフィールドが返されます。
  * データ型でフィールドをフィルタリングできます。特定の種類のフィールドを検索する場合に有効です。
* 使用例
  * リードのすべての選択リストフィールドを表示する
  * 取引先のすべての参照フィールドを取得する
  * 取引先責任者のすべてのテキストフィールドを一覧表示する
  * 商談のすべてのフィールドを取得する
  * 「イベントオブジェクトのすべての日時フィールドを検索する」
  * 「商談オブジェクトにはどのような通貨フィールドがありますか？」
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * テキストフィールド（文字列）
    * 数値フィールド（倍精度、整数）
    * 日付/時刻フィールド
    * 選択リストフィールド
    * 参照/ルックアップフィールド
    * 数式フィールド
    * その他

| 設定項目         | 説明                                                          |
| ------------ | ----------------------------------------------------------- |
| object\_name | オブジェクトのAPI名 (例: 'Lead'、'Account')                           |
| field\_type  | フィールドをフィルタリングするオプションの型 (例: 'picklist'、'reference'、'string') |

#### ツール名：Query Salesforce Records

* ツール概要
  * SOQL を使用して、フィルタリング、並べ替え、および制限オプションを使用して Salesforce レコードをクエリします。
* 使用例
  * 今月作成されたすべての取引先を取得する
  * 100,000ドルを超える商談を検索する
  * 優先度の高いケースとその取引先責任者を表示する
  * 「最近作成された5つの取引先を表示する」
  * 「今月成立する50,000ドルを超えるすべての商談を検索する」
  * 「役職が「CEO」の取引先責任者を会社名で並べ替えて一覧表示する」
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * 特定のフィールドの選択
    * オプションの WHERE フィルタリング条件
    * オプションの並べ替え (ORDER BY)
    * 返されるレコード数の制限

| 設定項目          | 説明                                  |
| ------------- | ----------------------------------- |
| object\_name  | クエリを実行するオブジェクトのAPI名 (例: 「取引先」、「商談」) |
| fields        | 取得するフィールドのリスト                       |
| where\_clause | オプションのフィルタリング条件                     |
| order\_by     | オプションの並べ替え条件                        |
| limit         | 返されるレコードの最大数 (デフォルト: 10)            |

#### ツール名：Get Salesforce Validation Rules

* ツール概要
  * 特定の Salesforce オブジェクトの検証ルールを取得します。
* 使用例
  * リードオブジェクトのすべての検証ルールを取得する
  * 商談オブジェクトの検証ルールを表示する
  * 取引先オブジェクトの有効な検証を一覧表示する
  * 「取引先責任者オブジェクトにはどのような検証ルールが適用されていますか？」
  * 「商談オブジェクトのすべてのデータ品質ルールを表示する」
  * 「取引先レコードの検証条件を一覧表示する」
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * ルール名とステータス（有効/無効）
    * ユーザーに表示されるエラーメッセージ
    * エラーが表示されるフィールド
    * ルールの説明
      * 特定の条件を満たさないレコードの保存を防止し、データ品質を強化します。

| 設定項目         | 説明                                  |
| ------------ | ----------------------------------- |
| object\_name | オブジェクトの API 名 (例: 「取引先」、「リード」、「商談」) |

#### ツール名：Manage Salesforce Debug Logs

* ツール概要
  * Salesforce ユーザーのデバッグログを管理します。ログの有効化、無効化、または取得が可能です。
  * 特定のユーザーのデバッグログを管理することで、トラブルシューティングに役立ちます。デバッグログは、コード実行、連携、自動化、その他の Salesforce 機能のトラブルシューティングに必要となります
  * 以下のことが可能です。
    * ログを有効にしてデバッグ情報を取得する
    * トラブルシューティングが完了したらログを無効にする
    * ログを取得して表示し、問題を分析する
    * ログの詳細レベルを設定する
* 使用例
  * ユーザーのデバッグログを有効にする
    * 'enable' 操作、ユーザー名、およびログレベルを指定します。
  * ユーザーのデバッグログを無効にする
    * 'disable' 操作とユーザー名を指定します。
  * ユーザーのデバッグログを取得する
    * 'retrieve' 操作とユーザー名を指定します。
  * 特定のログを完全な内容で取得する
    * 'retrieve' 操作、ユーザー名、log\_id、および include\_body=True を指定します。
  * 「<admin@example.com> のデバッグログを FINEST レベルで有効にする」
  * 「<user.name@company.com> のデバッグログを無効にする」
  * 「システム管理者の最新のデバッグログを取得する」
  * 「ログ ID 07L000000 のデバッグログの内容を表示する」
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * NONE
    * ERROR
    * WARN
    * INFO
    * DEBUG FINE
    * FINER
    * FINEST

| object\_name     | オブジェクトの API 名 (例: 「取引先」、「リード」、「商談」)                                                                        |
| ---------------- | ---------------------------------------------------------------------------------------------------------- |
| operation        | 実行する操作 - 'enable'、'disable'、または 'retrieve'                                                                 |
| username         | Salesforce ユーザーのユーザー名                                                                                      |
| log\_level       | <p>デバッグログのログレベル ('enable' 操作の場合は必須) 有効なオプション<br>有効なオプションは NONE、ERROR、WARN、INFO、DEBUG FINE、FINER、FINEST</p> |
| expiration\_time | デバッグログ設定の有効期限（分）（オプション、デフォルトは30）                                                                           |
| limit            | 取得するログの最大数（オプション、デフォルトは10）                                                                                 |
| log\_id          | 取得する特定のログのID（オプション）                                                                                        |
| include\_body    | ログの全内容を含めるかどうか（オプション、デフォルトはFalse）                                                                          |

#### ツール名：Check Salesforce Connection

* ツール概要
  * Salesforce への接続を確認し、組織の基本情報を返します。
  * このツールは、Salesforce 接続が正常に動作していることを検証し、接続された組織に関する以下の基本情報を返します。接続の問題を診断するための最初のステップとして、このツールをご利用ください。
  * 接続ステータス
  * ユーザー名
  * インスタンス URL
  * 環境タイプ（本番環境/サンドボックス環境）
  * 利用可能なオブジェクト数
* 使用例
  * 「Salesforce 接続が動作しているかどうかを確認する」
  * 「Salesforce API 接続を確認する」
  * 「Salesforce 組織への接続をテストする」
  * 「Salesforce 接続ステータスを表示する」

### Sequential Thinking <a href="#agent-creation" id="agent-creation"></a>

**概要**

構造化された思考プロセスを通じて動的かつ反射的な問題解決のためのツールを提供する MCP サーバー。

#### ツール名：sequentialthinking

* ツール概要
  * 本ツールは、単一の正解に到達するために、「内省」と「適応」を繰り返す動的な思考支援ツールです。 従来の直線的なロジックではなく、思考の修正、分岐、仮説検証を納得がいくまでループさせることで、不確実な問題に対しても精度の高い最終回答を導き出します。
  * 主な特徴
    * 柔軟な軌道修正： 過去の思考を否定・修正し、必要に応じて新たな推論パスへ分岐。
    * 仮説検証型アプローチ： 思考の連鎖（Chain of Thought）に基づき、仮説の立案と検証を反復。
    * 妥協のない品質： ユーザーが満足する「正解」に至るまで、思考ステップを無制限に拡張・調整。
* 使用例
  * 複雑な問題を段階的に分解する
  * 修正の余地のある計画と設計
  * 軌道修正が必要な分析
  * 当初は全体像が明確でない問題
  * 複数段階の解決策が必要な問題
  * 複数の段階にわたって文脈を維持する必要があるタスク
  * 無関係な情報を除外する必要がある状況

| thought           | <p>現在の思考ステップ。これには以下が含まれます。<br>-通常の分析ステップ<br>-以前の思考の修正<br>-以前の決定に関する疑問<br>-さらなる分析の必要性への気づき<br>-アプローチの変更<br>-仮説の生成<br>-仮説の検証</p> |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| nextThoughtNeeded | 思考の終わりに見えても、さらに思考が必要な場合は true になります。                                                                                           |
| thoughtNumber     | 現在の思考回数（必要に応じて最初の合計回数を超えることができます）                                                                                              |
| totalThoughts     | 現在必要な思考回数の見積もり（増減可能）                                                                                                           |
| isRevision        | この思考が以前の思考を修正するかどうかを示すブール値                                                                                                     |
| revisesThought    | is\_revision が true の場合、どの思考番号が再検討されているか                                                                                       |
| branchFromThought | 分岐の場合、どの思考番号が分岐点であるか                                                                                                           |
| branchId          | 現在の分岐の識別子（存在する場合のみ）                                                                                                            |
| needsMoreThoughts | 思考の終わりに近づいているが、さらに思考が必要であると気づいた場合                                                                                              |

### Slack MCP Server <a href="#agent-creation" id="agent-creation"></a>

**概要**

Slack API と連携できる MCP サーバーです。Botトークン認証とOAuth 認証のどちらにも対応しており、チャンネルやメッセージ、ユーザー操作など、ワークスペース全体の管理をまとめて行うことができます。

| 設定項目              | 説明                                                                                                      |
| ----------------- | ------------------------------------------------------------------------------------------------------- |
| SLACK\_BOT\_TOKEN | <p>Slack のボットが Slack API にアクセスするための認証キーです。<br>このトークンを使うことで、ボットはメッセージ送信やチャンネル操作など、許可された範囲の動作を実行できます。</p> |
| SLACK\_TEAM\_ID   | <p>Slack ワークスペースを識別するための ID です。<br>どのワークスペースに対して操作を行うかを指定するために利用されます。</p>                               |

#### ツール名：Get Timestamp

* ツール概要
  * 日付の表現を Unix タイムスタンプに変換します。
* 使用例
  * すべてのケースステータスの値を取得する
  * Lead.Source の選択リスト値を表示する
  * Account.Type のすべての値を一覧表示する
  * 「取引先で利用可能な業種オプションは何ですか？」
  * 「商談ステージで使用可能なすべての値を表示する」
* 入出力（引数と戻り値）
  * 引数（入力）：
    * expression (str):dateparser が解釈できる日付表現
      * 形式は「NUMBER UNIT TIMEZONE」で、例えば「2 week ago JST」や「1 week ago JST」のように入力します。
  * 戻り値（出力）:&#x20;
    * 以下の要素を含む辞書\
      ・timestamp (int): 秒単位の Unix タイムスタンプ。解析に失敗した場合は None。\
      ・error (str): 解析に失敗した場合のエラーメッセージ。成功した場合は None。

| 設定項目       | 説明                  |
| ---------- | ------------------- |
| expression | 解析したい日付や時間を表す文字列です。 |

#### ツール名：Get Channel Messages

* ツール概要
  * Slack チャンネルからメッセージを取得します。
* 入出力（引数と戻り値）
  * 引数（入力）：
    * channel\_id (str): メッセージを取得したいチャンネルの ID。必須。
    * oldest (int): 取得対象となるメッセージの開始時刻（Unix タイムスタンプ）。必須。
    * from\_user\_id (str | None): 特定ユーザーのメッセージのみ取得したい場合のユーザー ID。任意。
    * &#x20;latest (int | None): メッセージを取得する範囲の終了時刻（Unix タイムスタンプ）。任意。
    * time\_zone (str | None): メッセージのタイムスタンプに適用するタイムゾーン。任意。デフォルトは "Asia/Seoul"。
    * &#x20;limit (int, 任意): 取得するメッセージの最大数。デフォルトは 100。
  * 戻り値（出力）:&#x20;
    * メッセージスレッドのリストを含む辞書。各スレッドは複数のメッセージで構成されます。

| 設定項目           | 説明                                   |
| -------------- | ------------------------------------ |
| hannel\_id     | メッセージを取得したいチャンネルの ID。                |
| oldest         | 取得するメッセージの範囲の開始時刻（Unix タイムスタンプ）。     |
| from\_user\_id | 特定のユーザーに絞ってメッセージを取得したい場合のユーザー ID。任意。 |
| latest         | 取得するメッセージの範囲の終了時刻（Unix タイムスタンプ）。任意。  |
| time\_zone     | メッセージのタイムスタンプに適用するタイムゾーン。任意。         |
| limit          | 取得するメッセージの最大件数。任意。デフォルトは 100。        |

#### ツール名：Get Bot User Id

* ツール概要
  * Bot のユーザー ID を取得します。

#### ツール名：Get Joined Channels

* ツール概要
  * ユーザーが参加しているチャンネル一覧を取得します。必要に応じて、検索キーワードでチャンネルを絞り込むこともできます。\
    ※slack\_user\_id には、get\_bot\_user\_id ツールで取得した bot\_user\_id を指定するケースもあります。
* 入出力（引数と戻り値）
  * 引数（入力）：
    * slack\_user\_id (str):対象ユーザーの ID（例: U0123456789）。
    * search\_key (str | None):チャンネル名・トピック・説明文を対象にした検索キーワード。任意。
    * limit (int, optional):返すチャンネルの最大数。デフォルトは 30。
  * 戻り値（出力）:&#x20;
    * 以下の要素を含む辞書を返します。
      * channels (list):参加チャンネルのリスト。各チャンネルには id, name, name\_normalized, topic, purpose が含まれます。
      * has\_more (bool):取得件数が上限を超えており、まだチャンネルが残っているかどうか。
      * hint (str):さらにチャンネルがある場合に表示されるヒントメッセージ。

| 設定項目                             | 説明                          |                                  |
| -------------------------------- | --------------------------- | -------------------------------- |
| slack\_user\_id (str)            | 対象ユーザーの ID（例: U0123456789）。 |                                  |
| <p><br>search\_key (str          | None)</p>                   | チャンネル名・トピック・説明文を対象にした検索キーワード。任意。 |
| <p><br>limit (int, optional)</p> | 返すチャンネルの最大数。デフォルトは 30。      |                                  |

#### ツール名：Get Channels

* ツール概要
  * ワークスペース内に存在するすべてのチャンネルを取得します。必要に応じて、検索キーワードでチャンネルを絞り込むこともできます。
* 入出力（引数と戻り値）
  * 引数（入力）：
    * search\_key (str | None):チャンネル名・トピック・説明文を対象にした検索キーワード。任意。
    * limit (int, optional):返すチャンネルの最大数。デフォルトは 30。
  * 戻り値（出力）:&#x20;
    * 以下の要素を含む辞書を返します。
      * channels (list):取得したチャンネルのリスト。各チャンネルには id, name, name\_normalized, topic, purpose が含まれます。
      * has\_more (bool):取得件数が上限を超えており、まだチャンネルが残っているかどうか。
      * hint (str):さらにチャンネルがある場合に表示されるヒントメッセージ。

| 設定項目             | 説明                                                                        |
| ---------------- | ------------------------------------------------------------------------- |
| channels (list)  | 取得したチャンネルのリスト。各チャンネルには id, name, name\_normalized, topic, purpose が含まれます。 |
| has\_more (bool) | 取得件数が上限を超えており、まだチャンネルが残っているかどうか。                                          |
| hint (str)       | さらにチャンネルがある場合に表示されるヒントメッセージ。                                              |

#### ツール名：Get Users

* ツール概要
  * ワークスペースに所属するユーザー一覧を取得します。必要に応じて、検索キーワードでユーザーを絞り込むこともできます。
* 入出力（引数と戻り値）
  * 引数（入力）：
    * search\_key (str | None):ユーザーの本名または表示名を対象とした検索キーワード。任意
    * limit (int, optional):返すユーザーの最大数。デフォルトは 30。
  * 戻り値（出力）:&#x20;
    * 以下の要素を含む辞書を返します。
      * users (list):各ユーザーの id と name を含むユーザーオブジェクトのリスト。

| 設定項目                      | 内容                             |
| ------------------------- | ------------------------------ |
| search\_key (str \| None) | ユーザーの本名または表示名を対象とした検索キーワード。任意。 |
| limit (int, optional)     | 返すユーザーの最大数。デフォルトは 30。          |

#### ツール名：Get Channels Cached

* ツール概要
  * Slack ワークスペース内のチャンネルを取得・検索する機能です。SQLite を使ったキャッシュに対応しており、高速に結果を返します。
* 入出力（引数と戻り値）
  * 引数（入力）：
    * search\_key (str | None):ユーザーの本名または表示名を対象とした検索キーワード。任意
    * limit (int, optional):返すユーザーの最大数。デフォルトは 30。
  * 戻り値（出力）:&#x20;
    * 以下の要素を含む辞書を返します。
* 利用例
  * await get\_channels\_cached(search="general")
  * await get\_channels\_cached(search="dev", limit=100)
  * await get\_channels\_cached(from\_=0, limit=50) # 最初の50件を取得

| 設定項目   | 内容                                  |
| ------ | ----------------------------------- |
| search | チャンネル名または説明文に対する検索語（大文字・小文字を区別しない）。 |
| from   | ページネーションの開始位置（0 から始まる）。デフォルトは 0。    |
| limit  | 取得するチャンネルの最大数。デフォルト 50、最大 200。      |

#### ツール名：Send Message

* ツール概要
  * Slack のチャンネルにメッセージを送信します。スレッド返信にも対応しています。
* 入出力（引数と戻り値）
  * 引数（入力）：
    * channel:送信先チャンネルの ID（例: C1234567890）またはチャンネル名（例: #general）。\
      text:送信するメッセージ本文。
    * thread\_ts:スレッドとして返信する場合に指定する親メッセージのタイムスタンプ。任意。
  * 戻り値（出力）:&#x20;
    * 以下の要素を含む辞書
      * メッセージの詳細
      * ステータス
* 利用例
  * await send\_message("#general", "Hello world!")\
    {\
    "message": {\
    "ts": "1234567890.123456",\
    "channel": "C1234567890",\
    "text": "Hello world!"\
    },\
    "success": true\
    }

| 設定項目       | 内容                                                |
| ---------- | ------------------------------------------------- |
| channel    | 送信先チャンネルの IDまたはチャンネル名。送信先チャンネルの ID（例: C1234567890 |
| text       | 送信するメッセージ本文。                                      |
| thread\_ts | スレッドとして返信する場合に指定する親メッセージのタイムスタンプ。任意。              |

#### ツール名：Get Messages Cached

* ツール概要
  * Slack チャンネルからメッセージを取得する機能です。日時フィルタリングや SQLite キャッシュを活用し、効率よくメッセージを取得できます。
* 入出力（引数と戻り値）
  * 引数（入力）：
    * channel:取得対象となるチャンネルの ID（例: C1234567890）またはチャンネル名（例: #general）。
    * limit:取得する最大メッセージ数。デフォルトは 50、最大 1000。
    * oldest:取得範囲の開始日時（YYYY-MM-DD HH:MM:SS 形式）。この日時以降のメッセージを取得します。
    * latest:取得範囲の終了日時（YYYY-MM-DD HH:MM:SS 形式）。この日時までのメッセージを取得します。
    * timezone:日時の解釈に使用するタイムゾーン。指定がない場合はデフォルト設定が使用されます。
  * 戻り値（出力）:&#x20;
    * 以下の要素を含む辞書
      * メッセージ一覧
      * 取得メタデータ
      * キャッシュ情報
* 利用例
  * await send\_message("#general", "Hello world!")\
    {\
    "message": {\
    "ts": "1234567890.123456",\
    "channel": "C1234567890",\
    "text": "Hello world!"\
    },\
    "success": true

| 設定項目     | 説明                                                    |
| -------- | ----------------------------------------------------- |
| channel  | 取得対象となるチャンネルの IDまたはチャンネル名。例: C1234567890）             |
| limit    | 取得する最大メッセージ数。デフォルトは 50、最大 1000。                       |
| oldest   | 取得範囲の開始日時（YYYY-MM-DD HH:MM:SS 形式）。この日時以降のメッセージを取得します。 |
| latest   | 取得範囲の終了日時（YYYY-MM-DD HH:MM:SS 形式）。この日時までのメッセージを取得します。 |
| timezone | 日時の解釈に使用するタイムゾーン。指定がない場合はデフォルト設定が使用されます。              |

#### ツール名：Get Users Cached

* ツール概要
  * Slack ワークスペース内のユーザー情報を取得・検索する機能です。SQLite キャッシュを活用することで、高速かつ効率的にユーザーを探すことができます。
* 入出力（引数と戻り値）
  * 引数（入力）：
    * search:ユーザー名・メールアドレス・役職に対する検索語（大文字小文字は区別しない）。
    * from\_:ページネーションの開始位置（0 ベース）。デフォルトは 0。
    * limit:取得する最大ユーザー数。デフォルト 50、最大 200。
  * 戻り値（出力）:&#x20;
    * 以下の要素を含む辞書
      * 一致したユーザー
      * メタデータ
* 使用例
  * await get\_users\_cached(search="sato")
  * await get\_users\_cached(search="<john@company.com>")
  * await get\_users\_cached(from\_=0, limit=50) # 最初の50名を取得

| 設定項目   | 説明                                                |
| ------ | ------------------------------------------------- |
| search | <p>ユーザー名・メールアドレス・役職に対する検索語（大文字小文字は区別しない）。<br></p> |
| from\_ | ページネーションの開始位置（0 ベース）。デフォルトは 0。                    |
| limit  | 取得する最大ユーザー数。デフォルト 50、最大 200。                      |

#### ツール名：Search Messages

* ツール概要
  * ワークスペース内のすべてのチャンネルに対してメッセージ検索を行います。\
    ※ この機能を利用するには、user スコープの OAuth トークン（search:read 権限付き）が必要です。
* 入出力（引数と戻り値）
  * 引数（入力）：
    * query:検索したいキーワードやフレーズを含む検索クエリ文字列。
    * count:取得する検索結果の件数。デフォルトは 20、最大 100。
  * 戻り値（出力）:&#x20;
    * 以下の要素を含む辞書
      * 一致したユーザー
      * メタデータ
* 使用例
  * await search\_messages("project update", 10)\
    {\
    "messages": \[\
    {\
    "text": "Here's the project update...",\
    "user": "U1234567890",\
    "channel": "C1234567890",\
    "ts": "1234567890.123456"\
    }\
    ],\
    "query": "project update",\
    "total": 1\
    }

| 設定項目  | 説明                            |
| ----- | ----------------------------- |
| query | 検索したいキーワードやフレーズを含む検索クエリ文字列。   |
| count | 取得する検索結果の件数。デフォルトは 20、最大 100。 |

### Snowflake MCP Server <a href="#agent-creation" id="agent-creation"></a>

**概要**

Snowflake データベースへのアクセスおよび SQL クエリ実行を行うための MCP サーバーです。\
パスワード認証と RSA キー認証の双方に対応しており、DDL・DML・SELECT クエリなど、幅広い SQL 操作を包括的にサポートします。

#### ツール名：List Databases

* ツール概要
  * Snowflake 上で利用可能なすべてのデータベースを一覧表示します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * databases: データベース名のリスト
    * count: 検出されたデータベース数
* 使用例
  * list\_databases() -> { "databases": \["DEMO\_DB", "ANALYTICS\_DB", "REPORTING\_DB"], "count": 3 }

#### ツール名：List Schemas

* ツール概要
  * 指定したデータベース内に存在するすべてのスキーマを一覧表示します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * schemas: スキーマ名のリスト
    * database: クエリ対象となったデータベース名
    * count: 検出されたスキーマ数
* 使用例
  * list\_schemas("DEMO\_DB") -> { "schemas": \["PUBLIC", "RAW", "ANALYTICS"], "database": "DEMO\_DB", "count": 3 }

| 設定項目     | 説明           |
| -------- | ------------ |
| database | 対象となるデータベース名 |

#### ツール名：List Tables

* ツール概要
  * 指定したデータベースおよびスキーマ内に存在するすべてのテーブルを一覧表示します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * tables: テーブル名とコメントを含むオブジェクトのリスト
    * database: クエリ対象となったデータベース名
    * schema: クエリ対象となったスキーマ名
    * count: 検出されたテーブル数
* 使用例
  * list\_tables("DEMO\_DB", "PUBLIC") -> { \
    　"tables": \[ {\
    　　"table\_name": "CUSTOMERS", \
    　　"comment": "Customer information"\
    　　}, \
    　　{\
    　　"table\_name": "ORDERS", \
    　　"comment": "Order data"\
    　　}\
    &#x20;　], \
    "database": "DEMO\_DB", "schema": "PUBLIC", "count": 2 \
    }

| 設定項目     | 説明           |
| -------- | ------------ |
| database | 対象となるデータベース名 |
| schema   | 対象となるスキーマ名   |

#### ツール名：Describe Table

* ツール概要
  * 特定のテーブルに関するスキーマ情報（列定義）を取得します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * columns: 列名・データ型・NULL 可否・デフォルト値・コメントを含む列定義のリスト
    * table\_name: 完全修飾テーブル名
    * column\_count: 列数
* 使用例
  * describe\_table("DEMO\_DB.PUBLIC.CUSTOMERS") -> { \
    　"columns": \[ { \
    　　"column\_name": "CUSTOMER\_ID", \
    　　"data\_type": "NUMBER(38,0)", \
    　　"is\_nullable": "NO", \
    　　"column\_default": null, \
    　　"comment": "Primary key" \
    　　},\
    　 { \
    　　"column\_name": "CUSTOMER\_NAME", \
    　　"data\_type": "VARCHAR(100)", \
    　　"is\_nullable": "YES", \
    　　"column\_default": null, \
    　　"comment": "Customer full name" \
    　　} \
    　], \
    　"table\_name": "DEMO\_DB.PUBLIC.CUSTOMERS", "column\_count": 2 \
    }

| 設定項目        | 説明                                |
| ----------- | --------------------------------- |
| table\_name | database.schema.table形式で指定するテーブル名 |

#### ツール名：Read Query

* ツール概要
  * SELECT クエリを実行し、Snowflake からデータを読み取ります。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * data: クエリ結果（オブジェクト配列として返される）
    * row\_count: 取得された行数
    * query: 実行されたクエリ文字列
* 使用例
  * read\_query("SELECT \* FROM DEMO\_DB.PUBLIC.CUSTOMERS LIMIT 5") -> { \
    　"data": \[ \
    　{"CUSTOMER\_ID": 1, "CUSTOMER\_NAME": "John Doe"}, \
    　{"CUSTOMER\_ID": 2, "CUSTOMER\_NAME": "Jane Smith"} \
    　], \
    　"row\_count": 2,\
    　"query": "SELECT \* FROM DEMO\_DB.PUBLIC.CUSTOMERS LIMIT 5" \
    }

| 設定項目  | 説明                  |
| ----- | ------------------- |
| query | 実行する SELECT SQL クエリ |

#### ツール名：Write Query

* ツール概要
  * Snowflake に対して書き込み系クエリ（INSERT、UPDATE、DELETE）を実行します。\
    ※このツールは、書き込み操作が有効化されている場合にのみ利用できます。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * result: 実行結果メッセージ
    * query: 実行されたクエリ文字列
* 使用例
  * write\_query("INSERT INTO DEMO\_DB.PUBLIC.CUSTOMERS (CUSTOMER\_NAME) VALUES ('New Customer')") -> { \
    　"result": "1 row(s) affected", \
    　"query": "INSERT INTO DEMO\_DB.PUBLIC.CUSTOMERS (CUSTOMER\_NAME) VALUES ('New Customer')" \
    }

| 設定項目  | 説明                                    |
| ----- | ------------------------------------- |
| query | 実行する INSERT / UPDATE / DELETE SQL クエリ |

#### ツール名：Create Table

* ツール概要
  * Snowflake に新しいテーブルを作成します。\
    ※このツールは、書き込み操作が有効化されている場合にのみ利用できます。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * result: テーブル作成の確認メッセージ
    * query: 実行された CREATE TABLE 文
* 使用例
  * create\_table("CREATE TABLE DEMO\_DB.PUBLIC.NEW\_TABLE (ID NUMBER, NAME VARCHAR(100))") -> { \
    　　"result": "Table created successfully", \
    　　"query": "CREATE TABLE DEMO\_DB.PUBLIC.NEW\_TABLE (ID NUMBER, NAME VARCHAR(100))" \
    }

| 設定項目  | 説明                   |
| ----- | -------------------- |
| query | CREATE TABLE の SQL 文 |

#### ツール名：Execute Sql

* ツール概要
  * 任意の SQL クエリを Snowflake 上で実行します。\
    SELECT から DML・DDL まで、あらゆる SQL 文を実行できる汎用ツールです。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * data:SELECT クエリの場合は結果データ、それ以外のクエリの場合は実行情報（例：成功メッセージ）
    * query: 実行された SQL クエリ
    * query\_type: SQL 操作の種類（SELECT、INSERT、UPDATE など）
    * row\_count: 返された／影響を受けた行数
    * execution\_time: クエリの実行時間
* 使用例
  * execute\_sql("SELECT \* FROM DEMO\_DB.PUBLIC.CUSTOMERS LIMIT 3") -> { \
    　"data": \[{"CUSTOMER\_ID": 1, "CUSTOMER\_NAME": "John"}], \
    　"query": "SELECT \* FROM DEMO\_DB.PUBLIC.CUSTOMERS LIMIT 3", \
    　"query\_type": "SELECT", "row\_count": 1, "execution\_time": "0.5s" \
    }

    execute\_sql("CREATE TABLE test\_table (id NUMBER, name VARCHAR(100))") -> { \
    　"data": "Table created successfully", \
    　"query": "CREATE TABLE test\_table (id NUMBER, name VARCHAR(100))", \
    　"query\_type": "CREATE", "row\_count": 0, "execution\_time": "0.8s" \
    }

| 設定項目  | 説明                                                                     |
| ----- | ---------------------------------------------------------------------- |
| query | <p>実行する任意の SQL クエリ<br>（SELECT、INSERT、UPDATE、DELETE、CREATE、DROP など）</p> |

#### ツール名：Append Insight

* ツール概要
  * 分析で得られたデータインサイトをメモに追加し、後で参照できるようにします。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * message: インサイトがメモに追加されたことを示す確認メッセージ
    * insight: 追加されたインサイト内容
* 使用例
  * append\_insight("Customer retention rate has improved by 15% this quarter") -> {\
    　"message": "Insight added to memo",\
    　"insight": "Customer retention rate has improved by 15% this quarter"\
    }

| 設定項目    | 説明               |
| ------- | ---------------- |
| insight | 分析から得られたデータインサイト |

### Time <a href="#agent-creation" id="agent-creation"></a>

**概要**

時間およびタイムゾーン変換機能を提供する Model Context Protocol（MCP）サーバーです。

#### ツール名：get\_current\_time

* ツール概要
  * 指定したタイムゾーンの現在時刻を取得します。

| 設定項目     | 説明                                                                                                           |
| -------- | ------------------------------------------------------------------------------------------------------------ |
| timezone | <p>IANA タイムゾーン名（例：America/New\_York, Europe/London）。<br>ユーザーがタイムゾーンを指定しなかった場合は、ローカルタイムゾーンとして UTC を使用します。</p> |

#### ツール名：convert\_time

* ツール概要
  * タイムゾーン間で時刻を変換します。

| source\_timezone | <p>変換元の IANA タイムゾーン名（例：America/New\_York, Europe/London）。<br>ユーザーが変換元タイムゾーンを指定しなかった場合は、ローカルタイムゾーンとして UTC を使用します。</p>   |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------- |
| timezone         | 変換対象の時刻（24 時間形式：HH:MM）                                                                                                 |
| target\_timezone | <p>変換先の IANA タイムゾーン名（例：Asia/Tokyo, America/San\_Francisco）。<br>ユーザーが変換先タイムゾーンを指定しなかった場合は、ローカルタイムゾーンとして UTC を使用します。</p> |

### Time MCP Server <a href="#agent-creation" id="agent-creation"></a>

**概要**

時間関連の操作を行うための MCP サーバーで、エージェントが現在時刻の取得、タイムゾーン間の変換、日付・時刻の計算を実行できるようにします。

#### ツール名：Get Current Time

* ツール概要
  * 指定したタイムゾーンの現在時刻を取得します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * timezone: リクエストされたタイムゾーン
    * datetime: タイムゾーン情報付き ISO 形式の現在日時
    * is\_dst: サマータイム（DST）が有効かどうか
* 使用例
  * get\_current\_time("America/New\_York") -> { \
    　"timezone": "America/New\_York", \
    　"datetime": "2024-01-15T14:30:00-05:00", "is\_dst": false \
    }

| 設定項目     | 説明                                                             |
| -------- | -------------------------------------------------------------- |
| timezone | IANA タイムゾーン識別子（例：America/New\_York, Asia/Seoul, Europe/London） |

#### ツール名：Get Current Date

* ツール概要
  * 指定したタイムゾーンにおける現在の日付と曜日情報を取得します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * date: ISO 形式の日付（YYYY-MM-DD）
    * weekday: 数値で表した曜日（0＝月曜、1＝火曜、…、6＝日曜）
    * weekday\_name: 曜日の名称（例："Monday", "Tuesday"）
    * timezone: リクエストされたタイムゾーン
* 使用例
  * get\_current\_date("Asia/Tokyo") -> { \
    　"date": "2024-01-16", "weekday": 1, \
    　"weekday\_name": "Tuesday", \
    　"timezone": "Asia/Tokyo"\
    &#x20;}

| 設定項目     | 説明                                                   |
| -------- | ---------------------------------------------------- |
| timezone | IANA タイムゾーン識別子（例：America/New\_York, Asia/Seoul, UTC） |

#### ツール名：Convert Time

* ツール概要
  * タイムゾーン間で時刻を変換します。
* 入出力（引数と戻り値）
  * 戻り値（出力）:&#x20;
    * source: 変換元タイムゾーンの日時情報（datetime と DST 状態）
    * target: 変換先タイムゾーンの日時情報（変換後 datetime と DST 状態）
    * time\_difference: タイムゾーン間の時差（例："+5h", "-8.5h"）
* 使用例
  * convert\_time("Asia/Seoul", "09:00", "America/Los\_Angeles") -> {\
    　 "source": { "timezone": "Asia/Seoul", \
    　"datetime": "2024-01-16T09:00:00+09:00", \
    　"is\_dst": false \
    　}, \
    　"target": { \
    　"timezone": "America/Los\_Angeles", \
    　"datetime": "2024-01-15T16:00:00-08:00", \
    　# 前日 "is\_dst": false \
    　}, \
    "time\_difference": "-17h" \
    }

| 設定項目             | 説明                                     |
| ---------------- | -------------------------------------- |
| source\_timezone | 入力時刻の IANA タイムゾーン（例：America/New\_York） |
| timezone         | 24時間形式の時刻（HH:MM、例：14:30, 09:00, 23:45） |
| target\_timezone | 変換先の IANA タイムゾーン（例：Europe/London）      |

#### ツール名：Calculate Datetime

* ツール概要
  * 指定した日時に対して、さまざまな操作を適用して新しい日時を計算します。
  * このツールは、時間の加算・減算、特定の日付・時刻要素の設定など、多様な操作に対応しています。
* 入出力（引数と戻り値）
  * 引数（入力）：
    * datetime\_str
      * 開始日時または日付の文字列。形式：ISO datetime（例：2024-01-15T14:30:00）、タイムゾーン付き ISO（例：2024-01-15T14:30:00+09:00）、日付のみ（例：2024-01-15）
    * timezone
      * 計算に使用する IANA タイムゾーン（例：America/New\_York, Asia/Seoul, UTC）
  * 戻り値（出力）:&#x20;
    * original\_datetime: 入力として与えられた日時
    * original\_weekday: 入力日時の曜日番号（0＝月曜、6＝日曜）
    * original\_weekday\_name: 入力日時の曜日名（例："Monday"）
    * calculated\_datetime: 操作を適用した後の日時
    * calculated\_weekday: 計算結果の曜日番号
    * calculated\_weekday\_name: 計算結果の曜日名（例："Friday"）
    * timezone: 使用されたタイムゾーン
* 使用例
  * 3日と2時間を加算&#x20;
    * calculate\_datetime("2024-01-15T10:00:00", "UTC", relative\_days=3, relative\_hours=2) ->{ \
      　"original\_datetime": "2024-01-15T10:00:00+00:00", \
      　"original\_weekday": 0, \
      　"original\_weekday\_name": "Monday", \
      　"calculated\_datetime": "2024-01-18T12:00:00+00:00", \
      　"calculated\_weekday": 3, \
      　"calculated\_weekday\_name": "Thursday", \
      　"timezone": "UTC" \
      }

| 設定項目              | 説明                      |
| ----------------- | ----------------------- |
| relative\_days    | 増減させる日数（負の値で過去へ）        |
| relative\_weeks   | 増減させる週数                 |
| relative\_months  | 増減させる月数                 |
| relative\_years   | 増減させる年数                 |
| relative\_hours   | 増減させる時間数                |
| relative\_minutes | 増減させる分数                 |
| relative\_seconds | 増減させる秒数                 |
| day               | 月の日付を設定（1〜31）           |
| weekday           | 曜日を設定（0＝月曜、1＝火曜、…、6＝日曜） |
| month             | 月を設定（1〜12）              |
| year              | 年を設定（例：2025）            |
| hour              | 時刻（時）を設定（0〜23）          |
| minute            | 分を設定（0〜59）              |
| second            | 秒を設定（0〜59）              |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.allganize.ai/alli-llm-app-market/agent-builder/agent-builder-constraction.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
