接続する

概要

このページでは、Remote MCPとLocal MCPのどちらかを選び、Claude、ChatGPTデスクトップ、Codex、Cursor、VS Codeへ接続する方法を説明します。通常はインストールとAPIキーの管理が不要なRemote MCPを使い、ローカルファイルやヘッドレス環境が必要な場合だけLocal MCPを使います。

接続方法を選ぶ

接続方法は、実行環境とローカルファイルを扱う必要があるかどうかで選びます。

接続方法	適する用途	認証	インストール
Remote MCP	通常のAIクライアントから利用する	ブラウザOAuth	不要
Local MCP	ヘッドレス環境やローカルファイルを利用する	NoimosAIのAPIキー	Node.jsとnpmパッケージが必要

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

Remote MCPで接続する

Remote MCPは、NoimosAIがホストするエンドポイントをAIクライアントへ登録し、ブラウザでNoimosAIへのアクセスを認可する方式です。接続前に、次の2点を準備します。

NoimosAIアカウント
Streamable HTTPとOAuthに対応するMCPクライアント

接続先には、次のURLを使用します。

https://mcp.noimosai.com/mcp

利用するクライアントに応じて、次のいずれかの設定を行います。

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

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

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

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

ChatGPTデスクトップでは、MCPサーバーとして登録します。

Settings → MCP serversを開き、Add serverを選択します。
名前をNoimosAI、接続方式をStreamable HTTP、URLをhttps://mcp.noimosai.com/mcpに設定します。
保存してRestartを選択します。
サーバー一覧でAuthenticateを選び、ブラウザでNoimosAIへの認可を完了します。

会話画面で/mcpを入力すると、接続済みサーバーを確認できます。OpenAIの現行手順では、ChatGPT Webはローカル設定を読み込まず、インストール済みプラグインが提供するRemote MCPツールを使います。このページの直接接続手順はデスクトップ版が対象です。

Codex CLIでは、次のコマンドで接続先を追加してOAuth認証を開始します。

codex mcp add noimosai --url https://mcp.noimosai.com/mcp
codex mcp login noimosai

codex mcp listで登録状態を確認できます。ChatGPTデスクトップ、Codex CLI、Codex IDE拡張は、同じCodexホスト上のMCP設定を共有します。

Cursorでは、プロジェクトの.cursor/mcp.jsonへ次の設定を追加します。

{
  "mcpServers": {
    "noimosai": {
      "url": "https://mcp.noimosai.com/mcp"
    }
  }
}

CursorのMCP設定でNoimosAIを有効にし、表示されるブラウザ認証を完了します。

VS Codeでは、ワークスペースの.vscode/mcp.jsonへ次の設定を追加します。

{
  "servers": {
    "noimosai": {
      "type": "http",
      "url": "https://mcp.noimosai.com/mcp"
    }
  }
}

MCPサーバーを起動すると、VS CodeがブラウザでOAuth認証を開始します。

認可画面では、接続するNoimosAIアカウントとmcp:tools権限を確認します。認可後、クライアントを再接続し、NoimosAIのツールが表示されることを確認してください。

Local MCPで接続する

Local MCPは、npmで公開されている@noimosai/mcpをAIクライアントの子プロセスとして起動する方式です。接続前に、次の3点を準備します。

Node.js 20以降
STDIOに対応するMCPクライアント
NoimosAIのチーム設定にあるAPIタブで発行したAPIキー

以下のyour-api-keyを発行したキーへ置き換えます。デフォルトのワークスペースを固定する場合だけ、NOIMOS_WORKSPACE_IDも追加してください。

APIキーを含む設定ファイルをGitへコミットしたり、共有したりしないでください。ここで使うキーは通常のNoimosAI用であり、nmp_から始まるDeveloper Platformのキーは使用できません。

Claude Code
Claude Desktop
Codex
Cursor
VS Code

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

claude mcp add noimosai \
  --env NOIMOS_API_KEY=your-api-key \
  --env MCP_TOOL_TIMEOUT=900000 \
  -- npx -y @noimosai/mcp

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

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

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

codex mcp add noimosai \
  --env NOIMOS_API_KEY=your-api-key \
  --env NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS="$PWD" \
  -- npx -y @noimosai/mcp

このコマンドは、実行したフォルダだけをアップロードとダウンロードの許可範囲に設定します。

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

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

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

{
  "servers": {
    "noimosai": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@noimosai/mcp"],
      "env": {
        "NOIMOS_API_KEY": "your-api-key"
      }
    }
  }
}

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

変数名	必須	説明
`NOIMOS_API_KEY`	はい	NoimosAIのチーム設定にあるAPIタブで発行したAPIキーです。
`NOIMOS_WORKSPACE_ID`	いいえ	ツール呼び出しで`workspaceId`を省略した場合に使うデフォルトワークスペースIDです。
`NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS`	いいえ	Local MCPからアップロードを許可するローカルフォルダです。複数指定する場合はOSの区切り文字で分けます。

ローカルファイルを使う場合は、許可する範囲を必要なフォルダだけに限定してください。たとえば、現在のフォルダだけを許可する場合は、起動設定へNOIMOS_MCP_ALLOWED_UPLOAD_ROOTSの値として絶対パスを追加します。設定後にAIクライアントを再起動し、NoimosAIのツールが表示されることを確認します。chatやcreate_workspace_and_onboardは数分かかることがあるため、クライアント側でタイムアウトを変更できる場合は15分程度を目安にしてください。

最初のツールを試す

接続後は、読み取り専用の操作から始めると、対象ワークスペースと利用できる情報を安全に確認できます。 AIクライアントへ、次の順番で依頼します。

「NoimosAIで利用できるワークスペースを一覧にして」
「対象ワークスペースのブランド概要と接続済みアカウントを確認して」
「確認したブランド情報を使って、LinkedIn投稿を1案作って。公開はせず本文だけ提示して」

最初の2つではlist_workspacesとget_workspace_contextなどの読み取りツールが使われます。3つ目も公開操作を依頼していないため、内容を確認してから次の操作を決められます。

接続できない場合

接続できない場合は、利用している接続方法に応じて次の項目を確認します。

Remote MCPで認可画面が開かない — クライアントから接続先を削除し、もう一度登録します。
Remote MCPでツールが表示されない — mcp:tools権限が許可され、アカウントにワークスペースが存在することを確認します。
Remote MCPのトークンが期限切れになった — クライアントから再認可します。
Local MCPで起動できない — Node.js 20以降、npx、パッケージ名、APIキーを確認します。
Local MCPでワークスペースを選べない — NOIMOS_WORKSPACE_IDまたはツール呼び出しのworkspaceIdを確認します。
Local MCPでファイルを読めない — 対象ファイルがNOIMOS_MCP_ALLOWED_UPLOAD_ROOTSで許可したフォルダ内にあるか確認します。

はじめに

API

CLI

MCPサーバー

概要

接続方法を選ぶ

Remote MCPで接続する

Local MCPで接続する

最初のツールを試す

接続できない場合

関連ページ

​概要

​接続方法を選ぶ

​Remote MCPで接続する

​Local MCPで接続する

​最初のツールを試す

​接続できない場合

​関連ページ

概要

接続方法を選ぶ

Remote MCPで接続する

Local MCPで接続する

最初のツールを試す

接続できない場合

関連ページ