> ## 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.

# NoimosAI MCP サーバー

> Claude、ChatGPT、Cursor などの MCP 対応クライアントから NoimosAI を直接呼び出せます。

## 概要

NoimosAI MCP サーバーは、[Model Context Protocol](https://modelcontextprotocol.io) を介して NoimosAI ワークスペースを公開します。MCP 対応クライアントから、NoimosAI エージェントとのチャット、ワークスペースや連携アプリの一覧取得、SNS 投稿の公開といった操作を、クライアント内で直接行えます。

接続方法は 2 種類あります。

* **Remote MCP（推奨）** — `https://mcp.noimosai.com/mcp` でホスト済み。ブラウザ OAuth、インストール不要、あなたとして動作します。
* **Local MCP（`@agos-labs/noimosai-mcp`）** — npm 経由でローカル実行。API キー / ヘッドレス用途向け。

<Tabs>
  <Tab title="Remote（推奨）">
    エンドポイント: `https://mcp.noimosai.com/mcp`

    ### 必要なもの

    * NoimosAI アカウント（ログイン済み）
    * Remote MCP / Custom Connector 対応クライアント

    ### 認可

    クライアントが自己登録し、ブラウザで NoimosAI ログイン + `mcp:tools` スコープへの同意を行います。同意後、アクセストークンが発行され、以降のツール呼び出しは「あなた」として実行されます。

    ### 接続

    <Tabs>
      <Tab title="Claude Code">
        ```bash theme={null}
        claude mcp add --scope local --transport http noimos https://mcp.noimosai.com/mcp
        ```

        セッション内で `/mcp` を実行し、ブラウザで同意を完了させてから Claude Code に戻ります。
      </Tab>

      <Tab title="Claude.ai / Desktop">
        Settings → Connectors → **Add custom connector** → URL に `https://mcp.noimosai.com/mcp` → ブラウザでログインして同意。
      </Tab>

      <Tab title="ChatGPT Web">
        Custom MCP connector に URL `https://mcp.noimosai.com/mcp` を追加し、同意を完了します。ChatGPT は汎用の `search` / `fetch` ツールを自動検出しないので、NoimosAI のツールは名前を指定して呼び出してください。
      </Tab>
    </Tabs>

    ### 注意

    * `post` を呼ぶときは必ず最初に `dryRun: true` で送信内容を確認してください。`dryRun` を指定しないと本物の SNS アカウントに投稿されます。
    * 切断するときはクライアント側の connector を削除してください。

    ### トラブル

    * **認可画面に飛ばない** — connector を削除して再登録してください。
    * **ツールが空** — `mcp:tools` スコープの付与と、ワークスペースが存在することを確認してください。
    * **トークン切れ** — クライアントから再認可してください。
  </Tab>

  <Tab title="Local（npm）">
    npm に [`@agos-labs/noimosai-mcp`](https://www.npmjs.com/package/@agos-labs/noimosai-mcp) として公開。クライアントの子プロセスとして動作します。

    ### 動作要件

    * Node.js `>= 18`
    * MCP 対応クライアント（Claude Desktop、Cursor、VS Code など）
    * NoimosAI のチーム設定で発行した API キー

    ### 設定

    `your-api-key` と `your-workspace-id` は、NoimosAI のチーム設定で取得した値に置き換えてください。

    <Tabs>
      <Tab title="Claude Desktop">
        `claude_desktop_config.json` に次の設定を追加します。

        ```json theme={null}
        {
          "mcpServers": {
            "noimosai": {
              "command": "npx",
              "args": ["-y", "@agos-labs/noimosai-mcp"],
              "env": {
                "NOIMOS_API_KEY": "your-api-key",
                "NOIMOS_WORKSPACE_ID": "your-workspace-id"
              }
            }
          }
        }
        ```
      </Tab>

      <Tab title="Cursor">
        `.cursor/mcp.json` に次の設定を追加します。

        ```json theme={null}
        {
          "mcpServers": {
            "noimosai": {
              "command": "npx",
              "args": ["-y", "@agos-labs/noimosai-mcp"],
              "env": {
                "NOIMOS_API_KEY": "your-api-key",
                "NOIMOS_WORKSPACE_ID": "your-workspace-id"
              }
            }
          }
        }
        ```
      </Tab>

      <Tab title="VS Code">
        `.vscode/mcp.json` に次の設定を追加します。

        ```json theme={null}
        {
          "servers": {
            "noimosai": {
              "command": "npx",
              "args": ["-y", "@agos-labs/noimosai-mcp"],
              "env": {
                "NOIMOS_API_KEY": "your-api-key",
                "NOIMOS_WORKSPACE_ID": "your-workspace-id"
              }
            }
          }
        }
        ```
      </Tab>
    </Tabs>

    設定を更新したら、新しい MCP サーバーが認識されるようにクライアントを再起動してください。

    ### 環境変数

    | 変数名                   | 必須  | 説明                                        |
    | --------------------- | --- | ----------------------------------------- |
    | `NOIMOS_API_KEY`      | はい  | NoimosAI の API キー（チーム設定の API タブから取得できます）。 |
    | `NOIMOS_WORKSPACE_ID` | いいえ | ツール呼び出しで `workspaceId` を省略したときに使用される既定値。  |
  </Tab>
</Tabs>

## 提供ツール

Remote / Local いずれも同じツール群を公開します。

### `chat`

NoimosAI エージェントへメッセージを送信します。エージェントの応答と抽出された SNS 投稿を含む NoimosPostJson を返します。マーケティング分析、SNS 投稿作成、SEO 分析、コンテンツ生成に対応します。

| パラメータ         | 型        | 必須  | 説明                                                               |
| ------------- | -------- | --- | ---------------------------------------------------------------- |
| `prompt`      | `string` | はい  | エージェントへ送るメッセージや指示。                                               |
| `workspaceId` | `string` | いいえ | ワークスペース ID。指定がなければ `NOIMOS_WORKSPACE_ID`（Local）または認可済みアカウントの既定値。 |
| `sessionId`   | `string` | いいえ | 既存の会話を継続するセッション ID。省略時は新しいセッションが作成されます。                          |

### `list_workspaces`

利用可能なワークスペースの一覧（ID と名前）を返します。パラメータはありません。

### `list_integrations`

ワークスペースに接続済みの連携アプリ（SNS アカウント）の一覧を返します。返却される `providerAccountId` は `post` ツールの各エントリで必須です。

### `post`

SNS 投稿を公開します。`chat` が返す NoimosPostJson 形式の投稿データを受け付けます。各エントリには `providerAccountId`（`list_integrations` で取得）を必ず含めてください。本投稿前に必ず `dryRun: true` で内容を確認してください。

| パラメータ         | 型         | 必須  | 説明                                                      |
| ------------- | --------- | --- | ------------------------------------------------------- |
| `posts`       | `array`   | はい  | NoimosPostJson 形式の投稿の配列。各エントリに `providerAccountId` が必須。 |
| `schedule`    | `string`  | はい  | 公開タイミング。即時投稿は `"now"`、予約投稿は `"YYYY-MM-DD HH:MM"`。       |
| `workspaceId` | `string`  | いいえ | ワークスペース ID。指定がなければ既定のワークスペースを使用。                        |
| `dryRun`      | `boolean` | いいえ | `true` で送信内容のみ表示（公開しない）。既定値は `false`。                   |

## 関連ページ

* [NoimosAI とは？](/ja/help-center/getting-started/what-is-noimosai)
* [NoimosAI CLI](/ja/developers/cli/overview)
* [npm パッケージ](https://www.npmjs.com/package/@agos-labs/noimosai-mcp)