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

# 開発者向け機能

> API、CLI、MCPサーバーの違いと、目的に合った利用方法を説明します。

## 概要

このページでは、API、CLI、MCPサーバーの用途と、認証・データ・課金先の違いを説明します。NoimosAIをどこから、どのように使いたいかに合わせて利用方法を選べます。

## 目的に合う利用方法を選ぶ

次の3つを目安に、NoimosAIをどこから操作したいかで選びます。

<CardGroup cols={3}>
  <Card title="API" icon="code" href="/ja/developers/api/overview">
    自社サービスや業務システムへ、検索・分析・生成などの機能をコードで組み込みます。
  </Card>

  <Card title="CLI" icon="terminal" href="/ja/developers/cli/overview">
    ターミナルやCI/CDから、NoimosAIのワークスペースをコマンドで操作します。
  </Card>

  <Card title="MCPサーバー" icon="plug" href="/ja/developers/mcp/overview">
    Claude、ChatGPTデスクトップ、Codex、Cursorなどから、会話を通してNoimosAIを操作します。
  </Card>
</CardGroup>

## 認証・データ・課金先

APIは独立したDeveloper Platformを使います。CLIとMCPサーバーは、通常のNoimosAIワークスペースを外部から操作するための入口です。

| 比較項目    | API                                    | CLI                             | MCPサーバー                                     |
| ------- | -------------------------------------- | ------------------------------- | ------------------------------------------- |
| 主な利用者   | サービスやシステムの開発担当者                        | ターミナルを使う担当者、CI/CD               | MCP対応のAIを使う担当者                              |
| 使う場所    | 自社サービス、業務システム、サーバー                     | ターミナル、シェルスクリプト、CI/CD            | Claude、ChatGPTデスクトップ、Codex、Cursor、VS Codeなど |
| 操作方法    | HTTPリクエストをコードから送る                      | `noimosai`コマンドを実行する             | AIへ自然な言葉で依頼する                               |
| 認証      | Developer PlatformのAPIキー（`nmp_`）       | ブラウザOAuthまたはチーム設定のAPIキー         | RemoteはブラウザOAuth、Localはチーム設定のAPIキー          |
| 参照するデータ | Developer Platformのプロジェクトと、リクエストで渡した情報 | NoimosAIワークスペースのブランド、ナレッジ、連携アプリ | NoimosAIワークスペースのブランド、ナレッジ、連携アプリ             |
| 課金先     | Developer Platformの前払いUSD残高            | NoimosAIクレジット                   | NoimosAIクレジット                               |
| 向いている用途 | 製品への組み込み、大量処理、独自画面                     | 定型処理、手元での実行、CI/CD               | AIとの対話を起点にした調査・作成・操作                        |

<Warning>
  Developer PlatformのAPIキーと、通常のNoimosAIで発行するAPIキーは交換して使えません。認証に失敗した場合も、別の課金先やワークスペースへ自動的に切り替わることはありません。
</Warning>

## 利用するデータの境界

通常のNoimosAIでは、チームの中にワークスペースがあり、ワークスペースごとにブランド情報、ナレッジベース、接続済みアカウントを管理します。CLIとMCPサーバーは、このワークスペースを操作します。

Developer Platformは別の組織・プロジェクト・権限・残高を持ちます。APIから通常のNoimosAIワークスペース、ブランド情報、ナレッジベース、接続済みアカウントを暗黙に参照することはありません。必要な情報は、利用するツールの入力として明示します。
