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

# ツールを利用する

> MCPサーバーのチャット、投稿、分析、管理ツールの使い分けと安全な操作を説明します。

## 概要

このページでは、MCPサーバーで利用できるチャット、投稿、分析、生成、管理ツールの使い分けと、安全に実行するための注意点を説明します。目的に合う個別ツールがある場合は個別ツールを使い、複数段階の作業全体をNoimosAIエージェントへ任せる場合だけ`chat`を使います。

## ツールの呼び出し方を選ぶ

AIクライアントは、依頼に応じてNoimosAIのツールを選びます。個別ツールは処理を明示しやすく、通常は`chat`より速く、消費クレジットと実行範囲を把握しやすい方法です。

| 依頼                  | 選ぶ方法   | 例                                |
| ------------------- | ------ | -------------------------------- |
| 目的が1つに決まっている        | 個別ツール  | ワークスペースを一覧表示する、投稿を検索する、画像を1枚生成する |
| 複数の調査・判断・作成をまとめて任せる | `chat` | ブランドを調べ、企画を考え、複数の投稿案を作る          |

AIクライアントへ「利用可能なワークスペースを確認して」のように目的を伝えると、対応する個別ツールを選べます。ツール名を知っている場合は、「`list_workspaces`を使って」のように指定できます。

## `chat`へ一連の作業を依頼する

`chat`は、調査、分析、文章作成、メディア生成などを含む一連の作業をNoimosAIエージェントへ委任します。単独の検索や取得だけが目的の場合は、対応する個別ツールを優先してください。

| パラメータ            | 必須       | 説明                           |
| ---------------- | -------- | ---------------------------- |
| `deliverable`    | 新規会話では必須 | 作成するものと数量。例:「Instagram投稿を3案」 |
| `outputLanguage` | 新規会話では必須 | 出力言語。日本語は`ja`です。             |
| `prompt`         | はい       | 依頼の背景や補足です。                  |
| `audience`       | いいえ      | 誰に向けた内容かを指定します。              |
| `brandContext`   | いいえ      | 商品、価格、期間など、今回の依頼に必要な情報です。    |
| `voice`          | いいえ      | 文体や絵文字の使い方です。                |
| `constraints`    | いいえ      | 文字数、CTA、禁止表現などの条件です。         |
| `workspaceId`    | いいえ      | 対象ワークスペースIDです。               |
| `sessionId`      | いいえ      | 同じ成果物の修正を続ける場合に使う会話IDです。     |

成果物、対象プラットフォームとアカウント、読者、ブランドや商品・サービスの背景、文体、出力言語、文字数などを具体的に指定してください。

エージェントがユーザーの判断を必要とする場合、結果の`pendingQuestions`に質問が入り、処理が一時停止します。回答を含む`prompt`と同じ`sessionId`を指定して、もう一度`chat`を呼び出します。

## ワークスペースと連携アプリを確認する

対象のワークスペースと投稿先アカウントを確認・接続するには、次のツールを使います。

* `list_workspaces` — 利用可能なワークスペースのIDと名前を取得します。
* `list_integrations` — 接続済みの連携アプリと、投稿先指定に使うアカウントIDを取得します。
* `get_connect_url` — 指定したプロバイダーの接続画面をNoimosAIで開くURLを取得します。

新しい外部アカウントのOAuth接続は、取得したURLをブラウザで開いて完了します。その後、`list_integrations`でもう一度接続状態を確認してください。

## 投稿を下書き保存・公開する

`post`は、NoimosAIの投稿データ形式を使って、SNS投稿を下書き保存・即時公開・予約投稿します。接続先のAIが作成した投稿と、`chat`の結果に含まれる投稿のどちらも渡せます。

| パラメータ         | 型         | 必須   | 説明                                                 |
| ------------- | --------- | ---- | -------------------------------------------------- |
| `posts`       | `array`   | はい   | 投稿データの一覧です。投稿先には`list_integrations`のアカウントIDを使います。  |
| `mode`        | `string`  | いいえ  | `draft`、`publish`、`schedule`のいずれかです。省略時は`draft`です。 |
| `scheduleAt`  | `string`  | 条件付き | `mode: "schedule"`の場合に必須です。タイムゾーンを含めます。            |
| `workspaceId` | `string`  | いいえ  | 対象ワークスペースIDです。                                     |
| `dryRun`      | `boolean` | いいえ  | `true`にすると、公開せず投稿先と入力形式を確認します。                     |

実アカウントへ影響する操作では、最初に`dryRun: true`で投稿先を確認してください。投稿本文も確認し、承認後だけ`mode: "publish"`または`mode: "schedule"`を指定します。承認待ちの場合は`mode: "draft"`を使います。

<Warning>
  `dryRun`は投稿先と入力形式を確認する機能で、実際の公開成功を保証するものではありません。
</Warning>

## 投稿・記事・Webサイトを管理する

投稿後の管理や長文記事、Webサイトには、次の専用ツールを使います。

* `delete_posts` — 下書き・予約投稿を取り消し、公開済み投稿を削除します。
* `publish_article` — WordPress、X Articles、Substackへ長文記事を公開・予約します。
* `list_pinterest_boards` — Pinterest投稿に必要なボードIDを取得します。
* `create_website` / `publish_website` — Webサイトを作成・公開します。

公開済み投稿の削除は元に戻せません。手元のソースコードを送る`upload_website_source`はLocal MCP専用です。

## ブランドとナレッジベースを管理する

ブランド情報と参照データを整備するには、次のツールを使います。

* `get_workspace_context` — ブランド概要、目標、言語、接続済みアカウントをまとめて取得します。
* `get_workspace_brand` / `update_workspace_brand` — ブランドガイド全体を取得・更新します。
* `knowledge_dataset_*` / `knowledge_content_*` — ナレッジベースのデータセットとコンテンツを管理します。
* `create_workspace_and_onboard` — ワークスペースを作成し、AI調査を含むオンボーディングを実行します。

`get_workspace_context`は、`chat`の依頼文を作る前に前提情報を確認する場合に適しています。`update_workspace_brand`で`keywords`と`websites`を更新すると、それぞれの一覧全体が置き換わります。ナレッジベースへのコンテンツ取り込みでは、埋め込み処理のNoimosAIクレジットを消費します。ワークスペース作成にはプラン上限とチーム内の権限が適用されます。

## DMとコメントへ返信する

DMやコメントへ返信する場合は、対象IDを読み取りツールで取得してから、送信内容を確認します。

* `send_dm` — X、Instagram、Facebook、TikTokの既存DMスレッドへテキストを送信します。
* `reply_to_comment` — XまたはInstagramのコメント・メンションへ返信します。

これらのツールは下書きを作成せず、呼び出すとすぐに送信します。送信前に対象アカウント、対象ID、本文を提示し、明示的な了承を得てください。

DMの会話IDは`get_direct_messages`、コメント関連のIDは`list_x_user_mentions`、`instagram_comments_list`、`instagram_mentioned_comment_get`などで取得します。

## 個別の検索・分析・生成ツールを使う

接続時には、ワークスペースで利用できる個別ツールが読み込まれます。過去投稿、SNS検索、トレンド、GA4、Google Search Console、Semrush、サイト分析、調査、メディア生成などを必要に応じて実行できます。

ツール一覧で`[Billed]`と表示されるツールは、実際の処理量に応じてNoimosAIクレジットを消費します。オフラインまたは未認証の状態で起動した場合はツールカタログが読み込まれず、基本ツールだけが表示されることがあります。

## 画像・動画を生成する

画像・動画では、モデルと料金を確認してから生成し、作成履歴から状態や成果物を取得します。

| 段階          | 主なツール                                                               | 用途                                |
| ----------- | ------------------------------------------------------------------- | --------------------------------- |
| モデルを選ぶ      | `list_media_models`、`get_media_model_form`                          | 利用できるモデル、入力項目、対応機能を確認する           |
| 料金を確認する     | `get_media_model_cost`                                              | 生成前にNoimosAIクレジットの見積もりを確認する       |
| 生成・編集する     | `generate_image`、`generate_video`、`edit_image`、`edit_video`         | 新しいメディアを作成する、または既存メディアを編集する       |
| 状態と成果物を取得する | `get_creation`、`list_creations`、`get_media_url`、`download_creation` | 処理状態を確認し、生成ファイルを取得する              |
| 素材を準備する     | `upload_media`                                                      | Local MCPから許可済みのローカルファイルをアップロードする |

最初に「利用できる画像モデルを一覧にして」、次に「このモデルで正方形画像を1枚作る場合の見積もりと必要な入力を確認して」のように依頼します。モデル、入力、見積もりを確認した後だけ生成を実行してください。

`upload_media`は、指定したファイルの内容をNoimosAIへ送信します。対象ファイルと送信目的を確認し、そのファイルのアップロードを明示的に了承した後だけ実行してください。

## 影響のある操作を実行前に確認する

AIクライアントが操作を提案しても、次の操作では対象と内容を人が確認してから実行してください。

* 投稿、記事、Webサイトの公開や予約
* DMやコメントの送信
* 公開済み投稿の削除
* ブランド情報やナレッジベースの更新・削除
* ローカルファイルのアップロード
* NoimosAIクレジットを消費するツール

AIクライアント側に確認画面がある場合も、NoimosAI側の投稿先、ワークスペース、アカウントIDが意図した対象かを確認します。

## 関連ページ

接続設定やほかの利用方法は、次のページで確認できます。

* [接続する](/ja/developers/mcp/setup)
* [CLIの基本](/ja/developers/cli/overview)
* [npmパッケージ](https://www.npmjs.com/package/@noimosai/mcp)
