NoimosAI MCP サーバー

概要

NoimosAI MCP サーバーは、Model Context Protocol を介して NoimosAI ワークスペースを公開します。MCP 対応クライアントから、NoimosAI エージェントとのチャット、ワークスペースや連携アプリの一覧取得、SNS 投稿の公開といった操作を、クライアント内で直接行えます。接続方法は 2 種類あります。

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

Remote（推奨）
Local（npm）

エンドポイント: https://mcp.noimosai.com/mcp

必要なもの

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

認可

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

接続

Claude Code
Claude.ai / Desktop
ChatGPT Web

claude mcp add --scope local --transport http noimos https://mcp.noimosai.com/mcp

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

Settings → Connectors → Add custom connector → URL に https://mcp.noimosai.com/mcp → ブラウザでログインして同意。

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

注意

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

トラブル

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

npm に @agos-labs/noimosai-mcp として公開。クライアントの子プロセスとして動作します。

動作要件

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

設定

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

Claude Desktop
Cursor
VS Code

claude_desktop_config.json に次の設定を追加します。

{
  "mcpServers": {
    "noimosai": {
      "command": "npx",
      "args": ["-y", "@agos-labs/noimosai-mcp"],
      "env": {
        "NOIMOS_API_KEY": "your-api-key",
        "NOIMOS_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

.cursor/mcp.json に次の設定を追加します。

{
  "mcpServers": {
    "noimosai": {
      "command": "npx",
      "args": ["-y", "@agos-labs/noimosai-mcp"],
      "env": {
        "NOIMOS_API_KEY": "your-api-key",
        "NOIMOS_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

.vscode/mcp.json に次の設定を追加します。

{
  "servers": {
    "noimosai": {
      "command": "npx",
      "args": ["-y", "@agos-labs/noimosai-mcp"],
      "env": {
        "NOIMOS_API_KEY": "your-api-key",
        "NOIMOS_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

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

環境変数

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

提供ツール

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 MCP サーバー

概要

必要なもの

認可

接続

注意

トラブル

動作要件

設定

環境変数

提供ツール

`chat`

`list_workspaces`

`list_integrations`

`post`

関連ページ

開発者向け

Documentation Index

​概要

​必要なもの

​認可

​接続

​注意

​トラブル

​動作要件

​設定

​環境変数

​提供ツール

​chat

​list_workspaces

​list_integrations

​post

​関連ページ

概要

必要なもの

認可

接続

注意

トラブル

動作要件

設定

環境変数

提供ツール

`chat`

`list_workspaces`

`list_integrations`

`post`

関連ページ