mcpField
N
Nyxid

Nyxid

リモート
github.com/ChronoAIProject開発ツール40今日更新
リポジトリ

Nyxid について

NyxIDは、AIエージェントが公開・プライベートAPIへアクセスする際、生の認証情報をエージェントに渡さないオープンソースのゲートウェイです。認証情報の注入、NAT越しのローカルサービス接続、REST APIのMCPツール化に対応します。

主な機能

  1. 01API認証情報の自動注入
  2. 02NAT越しのローカルサービス接続
  3. 03REST APIのMCPツール化
  4. 04スコープ付きトークンによる分離
  5. 05OIDC、OAuth 2.0、RBAC

活用シーン

  1. 01鍵を共有せずにエージェントからプライベートAPIへ接続
  2. 02MCPエンドポイント経由で内部マイクロサービスを公開
  3. 03ファイアウォール内のセルフホストツールへ接続

MCP 対応

NyxIDはOpenAPI仕様のREST APIをMCPツールとして公開し、Claude CodeやCursorなどのクライアントにMCPエンドポイントを提供します。CLIでクライアント設定を生成できます。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://nyx.chrono-ai.fun/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

すべてのエンドポイント
Streamable HTTPhttps://nyx.chrono-ai.fun/mcp認証が必要

ツール

詳細

License: Apache-2.0 GitHub Stars Discord nyxid MCP server

NyxID — AI エージェントをあらゆる場所のあらゆる API に安全に接続します。

AI エージェントをあらゆる場所のあらゆる API に安全に接続します。 オープンソースのエージェント接続ゲートウェイです。

NyxID を使うと、AI エージェント(Claude Code、Cursor、n8n)が、公開・非公開を問わずあらゆる API にアクセスできます。認証情報はすべて NyxID が管理するため、エージェントがキーをそのまま目にすることはありません。

flowchart LR
    subgraph Agents["AI Agents"]
        CC[Claude Code]
        CU[Cursor]
        N8[n8n]
    end

    subgraph NyxID["NyxID Gateway"]
        AUTH[OIDC and API Key Auth]
        PROXY[Credential Injection Proxy]
        MCP[MCP Tool Wrapping]
    end

    subgraph Connectivity["Private Reach"]
        NODE[Credential Node]
    end

    subgraph Targets["Connected Services"]
        PUB[Public APIs]
        INT[Internal APIs]
        LOC[Localhost Services]
    end

    CC --> AUTH
    CU --> AUTH
    N8 --> AUTH

    AUTH --> PROXY
    PROXY --> MCP
    PROXY -->|Direct proxy| PUB
    PROXY -->|Private network| INT
    PROXY -->|NAT traversal| NODE
    NODE --> LOC

    classDef agents fill:#eef2ff,stroke:#4f46e5,color:#111827,stroke-width:1.5px;
    classDef gateway fill:#111827,stroke:#22d3ee,color:#ffffff,stroke-width:2px;
    classDef tooling fill:#e0f2fe,stroke:#0284c7,color:#0f172a,stroke-width:1.5px;
    classDef node fill:#fef3c7,stroke:#f59e0b,color:#111827,stroke-width:1.5px;
    classDef targets fill:#ecfeff,stroke:#14b8a6,color:#0f172a,stroke-width:1.5px;

    class CC,CU,N8 agents;
    class AUTH,PROXY gateway;
    class MCP tooling;
    class NODE node;
    class PUB,INT,LOC targets;

NyxID はリクエストをプロキシし、認証情報を自動的に注入します。また、NAT(ネットワークアドレス変換)を通過してローカルサービスに接続し、あらゆる REST API を MCP(Model Context Protocol)ツールとしてラップします。

管理者はサービスまたはリンク済みプロバイダーから、共有認証情報、アクセス権、エンドポイントルール、請求を設定できます。サービスの設定とベンダーの廃止を参照してください。また、他の管理者アクセス権を付与せずに、事前登録された使用状況閲覧者ロールなどを使って、プラットフォーム全体の使用状況レポートへの読み取り専用アクセス権をロールに付与できます。管理者向け使用状況を参照してください。 使用状況 → ダッシュボード/一覧では、ユーザー、請求先組織、サービス、期間の各フィルターを共有します。ダッシュボードのグラフでは、グループ化 → モデルを選択して、サービス内で記録されたモデルの使用状況を確認できます。グループ化、モデル情報の欠落、フィルターの仕様については、請求分析を参照してください。 管理者、オペレーター、使用状況閲覧者は、使用状況 → NyxBotを開いて、モデル別のコストと請求、トークンのトラフィック、請求額上位のアカウントに加え、アクティブなセッション数、ターンの結果、返信へのフィードバックを確認できます。正確な値、帰属、過去のデータの対象範囲については、NyxBot のモデル使用状況を参照してください。アクティビティの定義については、NyxBot のアクティビティを参照してください。

feature-flag-operator(フラグの作成と自身のフラグの管理)またはfeature-flag-admin(組み込みフラグを含むすべてのフラグの管理)を使って、任意のユーザーまたはグループに機能フラグへのアクセス権を委任できます。どちらのロールも「管理 → 機能フラグ」を使用します。機能フラグの管理を参照してください。

NyxID の機能

  • 繰り返し可能なクレジットを割り当てる — 管理者向け「クレジット」では、正確な一回限りまたは定期的な割り当て、任意の共有総額によるサービス上限、各割り当ての未使用残高の回収に対応しています。既存の無料単位の利用枠は別に維持されます。すべての請求書作成側をアップグレードするまで、新しいポリシーの作成は無効です。クレジット割り当ての会計処理と段階的導入を参照してください。

  • 電話・音声サービスを NyxBot に接続する — サービスアダプターを使うと、Telnyx/Twilio の着信通話と SMS、さらに ElevenLabs Custom LLM に対応できます。宣言された機能、検証済みの接続、専門ツールも利用できます。この機能はデフォルトで無効です。共有プラットフォームの Telnyx 音声は利用できません。

  • Oracle プールの所有権と廃止を管理する — プールの識別情報を維持したまま、自分のアカウントと管理対象組織の間でプールを移管できます。また、API と CLI を使ってアイドル状態のプールを削除できます。認証情報の更新と調整された段階的導入の要件については、Oracle プールのライフサイクルを参照してください。これらの変更を含む最初のタグ付きリリースで利用可能です。

  • チャットのレイアウトを調整する — デスクトップの 2 つのハンドルでメッセージ列の幅を変更するか、設定 → 表示で、全チャット共通の幅と最大入力欄の高さを設定できます。デスクトップの個々のスレッドには、長い会話を移動するためのメッセージインデックスが表示されます。また、スクロール時のフェードとコンパクトな会話コントロールで、読書スペースを確保できます。設定はこのブラウザーのすべてのチャットに適用されます。アシスタント UIをご覧ください。

  • NyxBot や専門エージェントと音声で会話する — 音声通話は保存済みのアカウント設定で開始され、入力欄にリアルタイムの字幕と音声アクティビティが表示されます。次回の通話のデフォルト設定は、入力欄のシェブロンにある音声設定で変更できます。ディクテーションでは、クリックで開始・停止する方式または長押しで話す方式、マイクの選択、下書きへの挿入前の文字起こしの確認が利用できます。プラットフォーム音声を利用するには、音声機能が有効で、プロバイダーと料金体系が設定され、十分な残高が必要です。音声の録音を開始すると、マイクへのアクセスが要求されます。音声とディクテーションをご覧ください。

  • NyxBot にソース画像を表示する — 対応する Notion の読み取りでは画像参照が返され、NyxBot はそれを暗号化されたチャット添付ファイルとして保持し、対応チャネルを通じて送信できます。共有取得ツールはソースへのアクセス権を再確認します。ソースリソースと画像表示をご覧ください。

  • NyxBot によるサービスの利用を管理する — NyxBot は保存済みの接続順序に従い、適切で利用可能な個人接続を優先します。また、「自動」と「毎回確認」では、組織の接続を利用する前に確認を求めます。権限モードを変更せずに、次のメッセージで使用する接続を指定できます。NyxBot のサービス実行をご覧ください。

  • NyxID クレジットで Telnyx ツールを利用する — Telnyx プラットフォームの提供内容では、HTTP または MCP を通じた、1 つのモデルによる非ストリーミングのテキストチャットの限定的なパイロット利用に対応しています。NyxBot のツール呼び出しも利用できます。利用を開始する前に、管理者は共有認証情報、検証済みのモデル範囲、料金、請求、パイロットアクセスを設定して有効にする必要があります。ユーザーが Telnyx OAuth に接続する必要はありません。

  • Stripe をエージェントに接続する — Stripe Apps OAuthでは、アカウント接続を管理し、顧客、請求書、支払い、サブスクリプションに関する読み取り専用ツールを利用できます。

  • エージェントをメールに接続する — Aurinko Email は、メールボックス API/MCP 操作用の AI サービスと、署名付きの受信通知や返信に対応するメールチャネルボットを提供します。アカウントトークンで接続できます。チャネルでは、アプリケーションの署名シークレットも使用します。

  • Telegram チャネルボットを作成する — Telegram New は、プラットフォーム管理の作成フローを使用するため、顧客はトークンをコピーすることなくボットを作成して接続できます。既存の Telegram オプションでは、引き続き現在のトークンを使ってボットを接続できます。Telegram New を有効にする前に、管理者が専用のマネージャーを設定します。

  • BotFather を Telegram アシスタントとして使用する — リンクされたマネージャーは、順序を保ったメッセージで返信全体を配信し、転送されたテキスト、引用、リンク、添付ファイルを保持します。コピー可能なコマンドまたは Telegram のリターンリンクと組み合わせて、Admin → Platform Bots で共有 FAQ/ユースケースライブラリをプレビュー、公開履歴、ロールバック機能とともに編集できます。複数のマネージャーで 1 つのライブラリを共有できます。BotFather のセットアップとゲートウェイの段階的な展開をご覧ください。

  • チャネルのスペシャリストにメンションする — 有効なグループ内で、正確なネイティブ Telegram および Lark/Feishu メンションを使用すると、参加者の OAuth なしで、受信側ボットにリンクされたエージェントにメッセージが届きます。ボットが作成したメッセージはゲストとして扱われ、永続的な引き継ぎ制限が適用されます。チャネルへの参加とゲートウェイの段階的な展開をご覧ください。

  • あらゆる場所にアクセスする — 公開 API、内部 API、認証情報ノード(nyxid node)経由の localhost サービスにアクセスできます。SSH(Secure Shell)トンネリング(nyxid ssh)でリモートホストに接続できます。VPN(Virtual Private Network)もポートフォワーディングも不要です。

  • キーを決して公開しない — リバースプロキシが認証情報を自動で挿入します。エージェントは NyxID と通信し、NyxID が実際のキーを使って API と通信します。

  • MCP の自動ラップ — OpenAPI 仕様を持つ REST API は、MCP(Model Context Protocol)ツールになります。nyxid mcp config --tool cursor で設定を生成できます。Claude Code、Cursor、VS Code、およびあらゆる MCP クライアントで動作します。

  • エージェントごとの分離 — 各エージェントにはスコープが制限されたトークンが割り当てられます。エージェント A は Slack と Gmail にアクセスし、エージェント B は内部 API のみにアクセスします。基盤となる認証情報に触れることなく、任意のセッションを失効できます。

  • 完全なアイデンティティレイヤー — PKCE(Proof Key for Code Exchange)を用いた OIDC(OpenID Connect)/OAuth 2.0、RBAC(Role-Based Access Control)、サービスアカウント、トランザクション承認(Telegram +モバイルプッシュ)、7 つのプロバイダーに対応する LLM(Large Language Model)ゲートウェイを備えています。

  • 必要に応じてサービスアクセスを追加する — アプリケーションは段階的な OAuth 同意をリクエストできます。新しいサービスを個別に表示しながら、リフレッシュトークンとブローカーのバインディングでは既存のアクセスを保持します。

動作を見る

ウェブアプリは 10 分ごとにフロントエンドの更新を確認します。アシスタントの更新は、安全にチャットを切り替えるとき、またはビューを切り替えるときに適用されます。15 分を過ぎても保留中のフロントエンドビルドがある場合は、Nyxbot ページを含め、更新を促すリマインダーが表示されます。 デプロイの動作をご覧ください。

エンドツーエンドの流れはシンプルです。サービスを一度 NyxID に接続すれば、NyxID MCP エンドポイントを指定したあらゆる AI エージェントが、元の API キーを見ることなくサービスを利用できます。

  1. ウェブコンソールでサービスを追加します。OpenAI(または Anthropic、GitHub など)のキーを一度貼り付けると、NyxID が暗号化して保存します。
  2. AI ツールを接続します。claude mcp add --transport http --scope user nyxid http://localhost:3001/mcp を実行するか、Cursor の Settings → MCP からワンクリックでインストールします。
  3. 利用する — Claude Code、Cursor、またはあらゆる MCP クライアントから、NyxID 経由でサービスを呼び出せるようになります。エージェントに見えるのは応答であり、キーではありません。

NyxID のエンドツーエンドデモ — サービスを接続し、MCP を設定して、プロキシ経由で呼び出す

▶ 全画面表示で視聴

## NyxIDを選ぶ理由

ほかのツールはそれぞれ一部の課題を解決しますが、NyxIDは認証情報の注入、NATトラバーサル、MCPツールを1つのオープンソースゲートウェイに統合しています。

NyxID1Password Universal AutofillCloudflare TunnelKeycloak
オープンソースはいいいえいいえはい
localhostへのNATトラバーサルはい(nyxid node)いいえはい(認証情報なし)いいえ
認証情報の注入はい(任意のAPI)パートナー連携いいえいいえ
RESTからMCPへの自動ラップはいいいえいいえいいえ
エージェントごとの分離はいいいえいいえいいえ
OIDC / OAuth 2.0はいいいえいいえはい

ユースケース

  • キーを共有せずに、Claude CodeからプライベートAPIにアクセスできるようにします
  • 単一のMCPエンドポイントを介して、内部マイクロサービスをAIエージェントに公開します
  • ファイアウォールの内側にあるセルフホスト可能なツール(Grafana、Jenkins、n8n)へのAIエージェントのアクセスを保護します

はじめに

NyxIDは2つの段階で使用します。まずnyxid CLIクライアントをインストールし、次にワークフローを選びます。CLIはホステッドサービスまたはセルフホストのバックエンドにログインし、ワークフローに必要なAgent Keyを作成できます。

1. NyxIDをインストールする

デフォルトの「NyxIDをインストール」手順では、軽量なnyxid CLIをインストールします。ユーザー単位でインストールされ、Dockerは不要で、バックエンドサーバーも起動しません。

クライアントだけが必要ですか?CLIをインストールしてください。独自のバックエンドを実行しますか?Dockerでセルフホストしてください。

bash -c "$(curl -fsSL https://raw.githubusercontent.com/ChronoAIProject/NyxID/main/skills/nyxid/scripts/install.sh)"

CLIをインストールしたら、ログイン先を選んでください。

ホステッドセルフホスト
概要NyxIDのバックエンドをクラウドで運用しますNyxIDのバックエンドを自分のマシンで運用します
おすすめの用途サーバーを設定せず、すぐに始めたい場合完全な制御、プライベートネットワーク、オフラインでの使用
ステータス登録受付中公開中 — 誰でも実行できます

AIコーディングエージェントからNyxIDを操作しますか? 以下の1行をいつでもエージェントに渡してください。nyxid CLIとNyxスキルファイルをインストールするよう指示できます。

Install nyx skills from https://github.com/ChronoAIProject/NyxID/blob/main/skills/INSTALL.md

エージェントはskills/INSTALL.mdを最初から最後まで読みます。デフォルトではCLIインストーラーを使用し、明示的にセルフホストを依頼した場合にのみDockerバックエンドのセットアップを実行します。

プラグインでのインストールを希望しますか? Claude CodeプラグインとCodexプラグインは、エージェントをNyxIDのホステッドMCPサーバーに接続し、MCPを優先するNyxIDスキルを同梱しています。CLIは不要です。最後のコマンドでNyxIDのサインイン画面が開きます。アプリを承認する際に、使用を許可するサービス(またはすべてのサービス)を選択してください。ツールを公開するには、その後サービスを接続します。

Claude Code

claude plugin marketplace add ChronoAIProject/NyxID
claude plugin install nyxid@nyxid
claude mcp login plugin:nyxid:nyxid

Codex

codex plugin marketplace add ChronoAIProject/NyxID
codex plugin add nyxid@nyxid
codex mcp login nyxid

claude mcp loginにはClaude Code 2.1.284以降が必要です。それ以前のバージョンでは、Claude Code内で/mcpを実行してサインインしてください。同じClaudeマーケットプレイスでは、skills/内のすべてのスキルを同梱したCLI版のnyxid-cli@nyxidも提供しています(上記でインストールしたnyxid CLIを呼び出します)。Cursor:integrations/cursor-plugin/をご覧ください。メンテナー向け情報:docs/PLUGINS.mdをご覧ください。

ホステッド(推奨)

Dockerもセットアップも不要で、1分以内にNyxIDを使い始められます。

  1. 新しいタブで**nyx.chrono-ai.fun/register**を開きます(Cmd/Ctrlキーを押しながらクリックするか、右クリックして「リンクを新しいタブで開く」を選択)。このチェックリストを開いたままにできます。
  2. Google、GitHub、またはAppleで登録します
  3. AI Servicesを開き、最初の外部サービスを追加して接続し、API Usageの検証用curlを実行します
  4. サービスの検証後、AIツールをNyxIDのMCPエンドポイントに接続します

クリック操作の全手順については、**最初のAIサービスを追加する**をご覧ください。

セルフホスト

お使いのマシンで独自の NyxID バックエンドを実行します。これは任意のサーバー側の方法で、3 つの Docker コンテナ(データベース、バックエンド、フロントエンド)をセットアップします。所要時間は約 2 分です。

前提条件: Docker と bash シェル。macOS と Linux には標準で備わっています。Windows ユーザーは、先に進む前に docs/WINDOWS_SETUP.md をご覧ください。このバックエンドの方法でのみ Docker が必要です。前提条件とディスク容量の詳細は SETUP.md をご覧ください。

AI を活用した方法(推奨)

Claude Code、Cursor、またはその他の AI コーディングアシスタントを開いている場合は、セルフホスト型バックエンドを明示的に使いたいときに限り、以下のプロンプトを貼り付けてください。事前確認、クローン、環境変数の生成、Docker スタック、ヘルスチェック、CLI ログイン、最初の認証情報、MCP 設定まで、セルフホストの全手順を実行します。

クリックして、AI を活用したセルフホスト用プロンプト全文を表示 > このマシンで NyxID バックエンドをセルフホストしたいです(リポジトリは https://github.com/ChronoAIProject/NyxID です)。これはデフォルトの CLI インストールではなく、Docker サーバーの手順です。セットアップ全体を対話形式で案内してください。失敗した場合や、自分で手順に沿って進めたい場合は、トラブルシューティング付きの詳しい手順が https://github.com/ChronoAIProject/NyxID/blob/main/docs/SETUP.md にあります。Windows を使っている場合は、先に WSL Ubuntu シェルから実行していること(ネイティブの PowerShell や CMD ではないこと)を確認してください。詳しくは https://github.com/ChronoAIProject/NyxID/blob/main/docs/WINDOWS_SETUP.md を参照してください。 > 1. 何かに触れる前に、Docker がインストール済みで、実行中であることを確認してください(`git`、`docker`、`openssl`、`curl`、Docker Compose v2、`docker info` を確認します)。 > 2. **クローンや生成を行う前に、NyxID のインストール状態が存在するか確認してください** — `./NyxID/.env.dev` ファイル、または `nyx*_mongodb_data` に一致する Docker ボリュームがないか確認します(`docker volume ls --format '{{.Name}}' | grep -E 'nyx.*_mongodb_data$'` を実行します。これはデフォルトの `nyxid_mongodb_data` と、名前を変更したチェックアウトによるすべてのバリエーションを検出します)。`./NyxID` ディレクトリだけでは「インストール済み」とは見なしません。`uninstall.sh` はソースツリーを残すため、状態がなくてもディレクトリが存在する場合があります。**インストール状態が存在する場合は、クイックスタートは初回インストール専用であると伝えて停止してください。** 先にアンインストールするか尋ねてください。(a) アンインストールする場合、`./NyxID` が存在するなら `cd NyxID && ./scripts/uninstall.sh --yes && cd ..` を実行します。古い Docker ボリュームだけが孤立している場合(チェックアウトを以前に手動で削除した場合)は、`docker volume ls --format '{{.Name}}' | grep -E 'nyx.*_mongodb_data$' | xargs -r docker volume rm` を直接実行します。どちらの方法でもボリュームとコンテナーが削除され、スクリプトを使う方法では `.env.dev` とキーも削除されます。NyxID のアカウントと暗号化された認証情報はすべて失われます。(b) 既存のインストールを維持してここで停止する場合は、`curl -sf http://localhost:3001/health` で引き続き実行中か確認できます。回答を得るまではステップ 3 に進まないでください。 > 3. `./NyxID` がすでに存在する場合(アンインストール後の再インストール)は、そのディレクトリに `cd` します。存在しない場合は、リポジトリを現在のディレクトリにクローンしてから、そのディレクトリに `cd` します。新しい `ENCRYPTION_KEY` と `MONGO_ROOT_PASSWORD` を設定して `.env.dev` を生成します(`ENVIRONMENT=development`、`AUTO_VERIFY_EMAIL=true`、`EMAIL_AUTH_ENABLED=true` を設定し、メール認証をすぐに完了できるようにします。初回の管理者セットアップ後、Admin > Feature Flags で `auth:invitation-code` 機能フラグを無効にすると、新規登録が開放されます)。`.env.production` にシンボリックリンクを作成し、`keys/` に PKCS#1 JWT 署名キーを作成します(`-RSAPublicKey_out` がサポートされない場合は、LibreSSL に対応するため `-pubout` を使います)。その後、イメージを取得して、`docker compose -f docker-compose.yml -f docker-compose.prod.yml --env-file .env.production up -d` でスタックを起動します。`http://localhost:3001/health` が 200 を返すまで最大 90 秒待ちます。タイムアウトした場合は、`docker logs nyxid-backend` を実行するよう伝えてください。ログに `SCRAM failure: Authentication failed` と表示される場合、以前のインストール時の古いパスワードが MongoDB ボリュームに残っています。`./scripts/uninstall.sh --yes` を実行するか(チェックアウトが存在しない場合は、`docker volume ls --format '{{.Name}}' | grep -E 'nyx.*_mongodb_data$' | xargs -r docker volume rm` を実行して Nyx 関連の孤立ボリュームを削除します)、再試行するよう伝えてください。生成された `ENCRYPTION_KEY` を表示し、バックアップできるようにしてください。 > 4. http://localhost:3000 を開いてアカウントを登録するよう伝えてください(開発モードではアカウントが自動認証されるため、メール認証は不要です)。登録したことを確認するまで待ってください。 > 5. `nyxid` CLI が使えることを確認してください。インストールされていない場合は、後でターミナルから NyxID を操作できるように、`nyxid` CLI と Nyx スキルをインストールするか尋ねてください。インストーラーは約 10 MB のビルド済みバイナリと少数のスキルファイルをダウンロードし(Rust ツールチェーンは不要です)、ロールバックに対応したバージョン管理レイアウトで CLI をインストールします。Rust ソースからビルドするのは、サポートされていない OS/アーキテクチャの組み合わせのみです。インストールする場合は、https://raw.githubusercontent.com/ChronoAIProject/NyxID/main/skills/INSTALL.md のインストールマニフェストに最後まで従ってください(CLI は `~/.local/share/nyxid/` にインストールされ、スキルはスキルディレクトリに配置されます。必要に応じて `export PATH="$HOME/.local/bin:$PATH"` を実行するよう案内されます)。次に `nyxid doctor` で確認し、`nyxid login --base-url http://localhost:3001` でログインして、`nyxid service add llm-openai --credential-env OPENAI_API_KEY` で OpenAI キーを追加します。`nyxid proxy request models` で確認してください。ここで `` には直前の `service add` コマンドが `Slug:` の下に表示した値を使います(通常は `llm-openai` ですが、同じスラッグのサービスがすでにある場合は接尾辞が付きます)。CLI を使わない場合は、代わりにウェブコンソールで同じ OpenAI 認証情報を追加する手順を案内してください。 > 6. 最後に、AI ツールを NyxID の MCP エンドポイント `http://localhost:3001/mcp` に接続します。Claude Code の場合:`claude mcp add --transport http --scope user nyxid http://localhost:3001/mcp`。Codex の場合:`codex mcp add nyxid --url http://localhost:3001/mcp`。Cursor の場合:ウェブコンソールで `Settings` > `MCP` を開き、`Install to Cursor` をクリックします。
手動セットアップ

オプションのバックエンドセットアップを自分で実行したい場合や、詳細なトラブルシューティングガイドが必要な場合は、docs/SETUP.md(macOS、Linux、または WSL 経由の Windows)を参照してください。

以下の内容を説明しています。

NyxID を起動し、http://localhost:3000 で登録したら、2. ワークフローを選ぶに進んでください。

本番環境へのデプロイ(TLS、カスタムドメイン、メール認証)については、docs/DEPLOYMENT.mdを参照してください。

2. ワークフローを選ぶ

NyxID アカウントを用意したら、構築したいものに合ったワークフローを選び、そのガイドで必要とされるアイデンティティを使用してください。それぞれ、動作する連携を完成させるまでの手順を順に説明しています。ガイドは互いに独立しており、どの順番でも完了できます。

クイックスタート成果NyxID の機能
ターミナルから NyxBot を実行するテキスト、ファイル、または標準入力からプロンプトを送信し、ファーストパーティのオーナーログインを使用して、永続的な処理の状況確認、完了待ち、キャンセルを行います。CLI はローカルで実行され、ホスト型またはセルフホスト可能な NyxID インスタンスを使用します。オーナー CLI と呼び出し API。サーバーの受け入れが有効である必要があります
n8n:1つの NyxID 認証情報で毎日の AI ニュースダイジェストを作成するn8n ワークフローが RSS フィードを取得し、各記事を Gemini で要約して Telegram に投稿します。n8n では1つの Header Auth 認証情報を使い、上流の Gemini と Telegram のシークレットは NyxID に保存します。サービスごとの認証情報の注入
Claude Code と Codex にエージェントごとのキーを設定する1台のマシン上で2つのコーディングエージェントを実行し、それぞれに異なるサービスと認証情報へのアクセス範囲を設定し、監査ログで個別に識別します。エージェントの分離、スコープ付き Agent Keys
クラウドホスト型エージェントからローカルホストの API に接続するVPN、ポートフォワーディング、トンネリングサービスを使わずに、クラウドエージェントからプライベートホストの API にアクセスできます。Credential Node、アウトバウンドのみの NAT トラバーサル
REST API を MCP ツールとしてラップするMCP サーバーのコードを書かずに、OpenAPI 仕様を型付き MCP ツールとして Claude Code / Cursor / VS Code / Codex に公開します。OpenAPI → MCP の自動ラップ
Supabase を AI エージェントのデータベースとして使用するSupabase プロジェクトを、スコープ付き AI エージェント向けの認証情報ブローカー経由の PostgREST データベースとして利用できます。ユーザーごとのエンドポイントと暗号化された API キー
Cloudflare、Supabase Management、または Railway に接続する共有 OAuth アプリまたは BYO OAuth アプリを通じてクラウドアカウントに接続し、スコープ付き管理 API にアクセスします。PKCE OAuth、暗号化されたトークン、更新

最初のプロキシ呼び出しで HTTP/1.1 200 が返るまでを、インターフェースごとに確認できるリファレンスガイド(Web UI · CLI · AI 駆動 · Direct API)については、Connecting AI Services ハブを参照してください。

AI サービスへの接続(インターフェースリファレンス)

Getting Started のワークフローを選ぶでは、ユースケース別に手順を整理しています。利用したいエントリーポイント(Web UI、CLI、AI 駆動(MCP)、または Direct API)でプロキシ呼び出しを確認するまでのインターフェース別リファレンスについては、**docs/connecting-services/**を参照してください。このハブでは、外部サービスの認証情報と NyxID Agent Keys を区別し、インターフェースごとの手順を案内しています。

リソース

トピックリンク説明
クイックスタートdocs/quickstarts/エンドツーエンドのレシピ — n8n、エージェントごとのキー、ノードプロキシ、MCP のラッピング
AI サービスへの接続docs/connecting-services/最初(または N 番目)の AI サービスを追加 — Web UI / CLI / AI による操作 / 直接 API
セットアップdocs/SETUP.md任意のセルフホスト型バックエンドとトラブルシューティング(macOS、Linux、WSL 経由の Windows)
Nyxbot のオンボーディングdocs/NYXBOT_ONBOARDING.mdオンボーディングの入口、既存の連携、保留中のバックエンド契約
NyxBot CLI と APIdocs/chat/09-owner-cli-api.mdオーナーコマンド、呼び出しのライフサイクル、セキュリティ境界、展開
デプロイdocs/DEPLOYMENT.md本番環境のセットアップはこちらから
AI エージェント向けプレイブックdocs/AI_AGENT_PLAYBOOK.mdエージェントの連携はこちらから
アーキテクチャdocs/ARCHITECTURE.mdシステム設計とデータフロー
API リファレンスdocs/API.md全エンドポイントのドキュメント
認証情報ノードdocs/NODE_PROXY.mdNAT トラバーサルのセットアップ
MCP 連携docs/MCP_DELEGATION_FLOW.mdMCP プロトコルの詳細
SSH トンネリングdocs/SSH_TUNNELING.mdWebSocket 経由のリモートホストへのアクセス
セキュリティdocs/SECURITY.md脅威モデルとセキュリティ強化
環境変数docs/ENV.md設定の完全なリファレンス
テレメトリdocs/TELEMETRY.mdオプトイン方式の利用状況分析 — ホットスワップ契約、イベント分類、同意と GDPR に基づくデータ消去
開発者ガイドdocs/DEVELOPER_GUIDE.mdローカル開発環境のセットアップ

コントリビューション

コントリビューションを歓迎します。CONTRIBUTING.mdをご覧ください。

ライセンス

Apache-2.0

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。