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

# 接続する

> Remote MCPまたはLocal MCPを対応するAIクライアントへ接続します。

## 概要

このページでは、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パッケージが必要 |

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

## Remote MCPで接続する

Remote MCPは、NoimosAIがホストするエンドポイントをAIクライアントへ登録し、ブラウザでNoimosAIへのアクセスを認可する方式です。

接続前に、次の2点を準備します。

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

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

```text theme={null}
https://mcp.noimosai.com/mcp
```

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

<Tabs>
  <Tab title="Claude Code">
    Claude Codeでは、次のコマンドで接続先を追加します。

    ```bash theme={null}
    claude mcp add --scope local --transport http noimosai https://mcp.noimosai.com/mcp
    ```

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

  <Tab title="Claude.ai / Desktop">
    Claude.aiまたはClaude Desktopでは、カスタムコネクターとして登録します。

    **Settings → Connectors → Add custom connector**を開き、URLに`https://mcp.noimosai.com/mcp`を入力します。保存後、ブラウザでNoimosAIへのログインと認可を完了してください。
  </Tab>

  <Tab title="ChatGPTデスクトップ">
    ChatGPTデスクトップでは、MCPサーバーとして登録します。

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

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

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

    ```bash theme={null}
    codex mcp add noimosai --url https://mcp.noimosai.com/mcp
    codex mcp login noimosai
    ```

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

  <Tab title="Cursor">
    Cursorでは、プロジェクトの`.cursor/mcp.json`へ次の設定を追加します。

    ```json theme={null}
    {
      "mcpServers": {
        "noimosai": {
          "url": "https://mcp.noimosai.com/mcp"
        }
      }
    }
    ```

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

  <Tab title="VS Code">
    VS Codeでは、ワークスペースの`.vscode/mcp.json`へ次の設定を追加します。

    ```json theme={null}
    {
      "servers": {
        "noimosai": {
          "type": "http",
          "url": "https://mcp.noimosai.com/mcp"
        }
      }
    }
    ```

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

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

## Local MCPで接続する

Local MCPは、npmで公開されている[`@noimosai/mcp`](https://www.npmjs.com/package/@noimosai/mcp)をAIクライアントの子プロセスとして起動する方式です。

接続前に、次の3点を準備します。

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

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

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

<Tabs>
  <Tab title="Claude Code">
    Claude Codeでは、次のコマンドでローカルサーバーを追加します。

    ```bash theme={null}
    claude mcp add noimosai \
      --env NOIMOS_API_KEY=your-api-key \
      --env MCP_TOOL_TIMEOUT=900000 \
      -- npx -y @noimosai/mcp
    ```
  </Tab>

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

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

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

    ```bash theme={null}
    codex mcp add noimosai \
      --env NOIMOS_API_KEY=your-api-key \
      --env NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS="$PWD" \
      -- npx -y @noimosai/mcp
    ```

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

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

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

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

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

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クライアントへ、次の順番で依頼します。

1. 「NoimosAIで利用できるワークスペースを一覧にして」
2. 「対象ワークスペースのブランド概要と接続済みアカウントを確認して」
3. 「確認したブランド情報を使って、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`で許可したフォルダ内にあるか確認します。

## 関連ページ

接続後のツールの選び方とほかの利用方法は、次のページで確認できます。

* [ツールを利用する](/ja/developers/mcp/tools)
* [CLIの基本](/ja/developers/cli/overview)
* [MCPの標準的な接続手順](https://modelcontextprotocol.io/docs/develop/connect-local-servers)