NoimosAI MCP サーバー

概要

NoimosAI MCP サーバーは、Model Context Protocol を介して NoimosAI ワークスペースのデータと機能を MCP 対応クライアントへ公開します。接続先のAIは、ブランド情報や過去の投稿、分析データを参照し、コンテンツ作成から下書き保存・公開・予約投稿まで実行できます。接続方法は次の 2 種類です。

Remote MCP（推奨） — https://mcp.noimosai.com/mcp へ接続します。ブラウザ OAuth を使用するため、ローカルインストールや API キーの設定は不要です。
Local MCP（@noimosai/mcp） — npm パッケージをローカルで実行します。API キーを使うヘッドレス環境や、ローカルプロセスとして接続したい場合に適しています。

迷った場合は Remote MCP を選んでください。Local MCP は、CI/CD で利用する場合や、手元のファイルを直接アップロードする場合に向いています。

Remote（推奨）
Local（npm）

Remote MCP は、NoimosAI がホストするエンドポイントへブラウザ OAuth で接続する方法です。エンドポイント: https://mcp.noimosai.com/mcp

必要なもの

接続前に次の条件を確認してください。

NoimosAI アカウント
Remote MCPまたはカスタムコネクターに対応するクライアント

認可

クライアントを登録すると、ブラウザで NoimosAI へのログインと mcp:tools スコープへの同意を求められます。同意後にアクセストークンが発行され、ツールは認可したユーザーとして実行されます。

接続

利用するクライアントに応じて、次の方法で接続します。

Claude Code
Claude.ai / Desktop
ChatGPT Web

Claude Codeでは、次のコマンドで接続先を追加します。

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

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

Claude.aiまたはClaude Desktopでは、カスタムコネクターとして登録します。Settings → Connectors → Add custom connector を開き、URL に https://mcp.noimosai.com/mcp を入力して、ブラウザでログインと認可を完了します。

ChatGPT Webでは、Developer modeを有効にしてカスタムアプリとして登録します。Settings または Workspace Settings から Apps → Create を開き、URL に https://mcp.noimosai.com/mcp を入力します。ツールをスキャンし、ブラウザで NoimosAI の認可を完了してください。書き込みを含むMCPアプリは、ChatGPT Business、Enterprise、EduのWeb版で利用できます。Proでは読み取り用ツールに制限されます。詳しくはOpenAIの案内を確認してください。

トラブルシューティング

Remote MCPで接続できない場合は、次の項目を確認してください。

認可画面が開かない — クライアントからコネクターを削除し、もう一度登録してください。
ツールが表示されない — mcp:tools スコープが許可され、アカウントにワークスペースが存在することを確認してください。
トークンが期限切れになった — クライアントから再認可してください。
接続を解除したい — クライアント側でコネクターを削除してください。

Local MCP は、npm で公開されている @noimosai/mcp をクライアントの子プロセスとして実行する方法です。

動作要件

ローカル接続を設定する前に次の条件を確認してください。

Node.js >= 20
MCP 対応クライアント（Claude Code、Claude Desktop、Cursor、VS Code など）
NoimosAI のチーム設定にある API タブで発行した API キー
任意のデフォルトワークスペース ID

設定

your-api-key と your-workspace-id は、NoimosAI で取得した値に置き換えてください。Claude Codeでは、長時間処理に備えて MCP_TOOL_TIMEOUT=900000（15分）も設定します。

Claude Code
Claude Desktop
Cursor
VS Code

Claude Codeでは、次のコマンドでローカルサーバーを追加します。

claude mcp add noimosai \
  --env NOIMOS_API_KEY=your-api-key \
  --env NOIMOS_WORKSPACE_ID=your-workspace-id \
  --env MCP_TOOL_TIMEOUT=900000 \
  -- pnpm dlx @noimosai/mcp

Claude Desktopでは、claude_desktop_config.json に次の設定を追加します。

{
  "mcpServers": {
    "noimosai": {
      "command": "pnpm",
      "args": ["dlx", "@noimosai/mcp"],
      "env": {
        "NOIMOS_API_KEY": "your-api-key",
        "NOIMOS_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

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

{
  "mcpServers": {
    "noimosai": {
      "command": "pnpm",
      "args": ["dlx", "@noimosai/mcp"],
      "env": {
        "NOIMOS_API_KEY": "your-api-key",
        "NOIMOS_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

VS Codeでは、.vscode/mcp.json に次の設定を追加します。

{
  "servers": {
    "noimosai": {
      "command": "pnpm",
      "args": ["dlx", "@noimosai/mcp"],
      "env": {
        "NOIMOS_API_KEY": "your-api-key",
        "NOIMOS_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

設定後にクライアントを再起動し、NoimosAI のツールが表示されることを確認してください。

環境変数

Local MCPでは、次の環境変数を利用します。

変数名	必須	説明
`NOIMOS_API_KEY`	はい	NoimosAI の API キー。チーム設定の API タブから取得します。
`NOIMOS_WORKSPACE_ID`	いいえ	ツール呼び出しで `workspaceId` を省略した場合に使うデフォルトワークスペース ID。

chat や create_workspace_and_onboard は、AI調査のため数分かかることがあります。クライアント側でタイムアウトを変更できる場合は、15分程度を目安にしてください。

Remote MCPでは、手元のファイルを直接読む upload_media と upload_website_source は利用できません。これらが必要な場合はLocal MCPを使ってください。

ツールの使い分け

NoimosAI MCPでは、必要な機能を個別に実行する方法と、chat で一連の作業をまとめて依頼する方法があります。データ確認や投稿保存には個別ツール、調査から成果物作成まで任せたい場合は chat が適しています。

`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を取得します。ユーザーがブラウザで接続を完了した後、list_integrations で確認してください。

`post`

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

パラメータ	型	必須	説明
`posts`	`array`	はい	投稿データの一覧。投稿先アカウントは `list_integrations` の結果を使って指定します。
`mode`	`string`	いいえ	`"draft"`、`"publish"`、`"schedule"` のいずれか。省略時は `"draft"`。意図を明確にするため、常に明示することを推奨します。
`scheduleAt`	`string`	条件付き	`mode: "schedule"` の場合に必須。`"2026-08-20T09:00:00+09:00"` のようにタイムゾーンを含めます。
`workspaceId`	`string`	いいえ	対象ワークスペース ID。省略時はデフォルトワークスペースを使用します。
`dryRun`	`boolean`	いいえ	`true` にすると、公開せずに投稿先と入力形式を確認できます。実際の公開成功を保証するものではありません。

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

投稿・記事・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 — ブランド概要、目標、言語、接続済みアカウントをまとめて取得します。chat の依頼文を作る前の確認に適しています。
get_workspace_brand / update_workspace_brand — ブランドガイド全体を取得・更新します。keywords と websites を更新するときは、それぞれの一覧全体が置き換わります。
knowledge_dataset_* / knowledge_content_* — ナレッジベースのデータセットとコンテンツを作成・取得・更新・削除します。コンテンツ取り込みでは埋め込み処理のクレジットを消費します。
create_workspace_and_onboard — ワークスペースを作成し、AI調査を含むオンボーディングを実行します。プランの上限とチーム内の権限が適用され、外部アカウントのOAuth接続は別途ブラウザで行います。

受信箱への返信

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 クレジットを消費します。オフラインまたは未認証の状態で起動した場合はツールカタログが読み込まれず、基本ツールだけが表示されることがあります。

開発者向け

NoimosAI MCP サーバー

概要

必要なもの

認可

接続

トラブルシューティング

動作要件

設定

環境変数

ツールの使い分け

`chat`

ワークスペースと連携アプリ

`post`

投稿・記事・Webサイトの管理

ブランドとナレッジベース

受信箱への返信

データ取得・分析などの個別ツール

関連ページ

​概要

​必要なもの

​認可

​接続

​トラブルシューティング

​動作要件

​設定

​環境変数

​ツールの使い分け

​chat

​ワークスペースと連携アプリ

​post

​投稿・記事・Webサイトの管理

​ブランドとナレッジベース

​受信箱への返信

​データ取得・分析などの個別ツール

​関連ページ

概要

必要なもの

認可

接続

トラブルシューティング

動作要件

設定

環境変数

ツールの使い分け

`chat`

ワークスペースと連携アプリ

`post`

投稿・記事・Webサイトの管理

ブランドとナレッジベース

受信箱への返信

データ取得・分析などの個別ツール

関連ページ