World Monitor
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Read-only Alga PSA MCP server: 42 curated GET tools for tickets, clients, time and billing.
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 0/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 12/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 12/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)
使っているAIアプリを選んで、設定をコピーしてください。
ひとことで AI にインストールしてもらう
Alga PSA をインストールして。https://mcp.popnx.com/i/wyre-ai-alga-psa-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
Alga PSA のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (ALGA_INSTANCE_URL) · 先にパソコンへ Docker を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude に MCP server Alga PSA を入れてください。順番に:1) docker --version で Docker があるか確認。なければ https://www.docker.com/products/docker-desktop/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "alga-psa": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "ALGA_INSTANCE_URL", "-e", "ALGA_API_KEY", "ghcr.io/wyre-ai/alga-psa-mcp:v1.0.0" ], "env": { "ALGA_INSTANCE_URL": "your-value", "ALGA_API_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) ALGA_API_KEY, ALGA_INSTANCE_URL は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Alga PSA のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
docker --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: Docker Desktop を入れます:Mac は Docker.dmg を開いてアイコンを「アプリケーション」へドラッグ(Mac に合わせて Apple silicon か Intel を選ぶ)· Windows は Docker Desktop Installer.exe をダブルクリック · 入れたら Docker Desktop アプリを開いたままにします。curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: docker --version
一度入れれば、Docker を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
ALGA_INSTANCE_URL The https:// address you use to sign in to Alga, for example https://psa.example.com. A trailing / or /api/v1 is fine; leave off any other path. Works for Nine Minds–hosted and self-hosted instances.…説明は英語の原文のままです。
SettingsDeveloperEdit Config
{
"mcpServers": {
"alga-psa": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ALGA_INSTANCE_URL",
"-e",
"ALGA_API_KEY",
"ghcr.io/wyre-ai/alga-psa-mcp:v1.0.0"
],
"env": {
"ALGA_INSTANCE_URL": "your-value",
"ALGA_API_KEY": "your-value"
}
}
}
}キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Alga PSA を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が Alga PSA を使っていると言うか、回答に Alga PSA のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
ALGA_TENANT_ID 任意。Alga サポートから指定されない限り空欄のままにしてください。誤った値を設定すると、すべてのリクエストが失敗します。 ALGA_TOOL_TIERS Comma-separated tool tiers. Every tool is read-only, so the only valid value is read (the default). The X-Conduit-Tool-Tiers request header can only narrow this set. · 初期値 read説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ Alga PSA につなげません
Alga PSA はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
A · Alga PSA につなげるアプリを使う
B · その他 の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
Claude Code につなげますが、先に準備が必要です
Alga PSA のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (ALGA_INSTANCE_URL) · 先にパソコンへ Docker を入れてください(1 回だけ)
このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude Code に MCP server Alga PSA を入れてください。順番に:1) docker --version で Docker があるか確認。なければ https://www.docker.com/products/docker-desktop/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user alga-psa --env ALGA_INSTANCE_URL=your-value --env ALGA_API_KEY=your-value -- docker run -i --rm -e ALGA_INSTANCE_URL -e ALGA_API_KEY ghcr.io/wyre-ai/alga-psa-mcp:v1.0.0 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) ALGA_API_KEY, ALGA_INSTANCE_URL は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Alga PSA のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
docker --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: Docker Desktop を入れます:Mac は Docker.dmg を開いてアイコンを「アプリケーション」へドラッグ(Mac に合わせて Apple silicon か Intel を選ぶ)· Windows は Docker Desktop Installer.exe をダブルクリック · 入れたら Docker Desktop アプリを開いたままにします。curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: docker --version
一度入れれば、Docker を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
ALGA_INSTANCE_URL The https:// address you use to sign in to Alga, for example https://psa.example.com. A trailing / or /api/v1 is fine; leave off any other path. Works for Nine Minds–hosted and self-hosted instances.…説明は英語の原文のままです。
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
claude mcp add --scope user alga-psa --env ALGA_INSTANCE_URL=your-value --env ALGA_API_KEY=your-value -- docker run -i --rm -e ALGA_INSTANCE_URL -e ALGA_API_KEY ghcr.io/wyre-ai/alga-psa-mcp:v1.0.0Enter の前に「your-value」を自分のキーに書き換えてください
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Alga PSA が一覧にあり、接続済みと表示されれば OK です
Alga PSA を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が Alga PSA を使っていると言うか、回答に Alga PSA のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
ALGA_TENANT_ID 任意。Alga サポートから指定されない限り空欄のままにしてください。誤った値を設定すると、すべてのリクエストが失敗します。 ALGA_TOOL_TIERS Comma-separated tool tiers. Every tool is read-only, so the only valid value is read (the default). The X-Conduit-Tool-Tiers request header can only narrow this set. · 初期値 read説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
Alga PSA のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (ALGA_INSTANCE_URL) · 先にパソコンへ Docker を入れてください(1 回だけ)
このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Cursor に MCP server Alga PSA を入れてください。順番に:1) docker --version で Docker があるか確認。なければ https://www.docker.com/products/docker-desktop/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "alga-psa": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "ALGA_INSTANCE_URL", "-e", "ALGA_API_KEY", "ghcr.io/wyre-ai/alga-psa-mcp:v1.0.0" ], "env": { "ALGA_INSTANCE_URL": "your-value", "ALGA_API_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) ALGA_API_KEY, ALGA_INSTANCE_URL は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Alga PSA のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
docker --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: Docker Desktop を入れます:Mac は Docker.dmg を開いてアイコンを「アプリケーション」へドラッグ(Mac に合わせて Apple silicon か Intel を選ぶ)· Windows は Docker Desktop Installer.exe をダブルクリック · 入れたら Docker Desktop アプリを開いたままにします。curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: docker --version
一度入れれば、Docker を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
ALGA_INSTANCE_URL The https:// address you use to sign in to Alga, for example https://psa.example.com. A trailing / or /api/v1 is fine; leave off any other path. Works for Nine Minds–hosted and self-hosted instances.…説明は英語の原文のままです。
Alga PSA の設定で ALGA_API_KEY, ALGA_INSTANCE_URL が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Alga PSA を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が Alga PSA を使っていると言うか、回答に Alga PSA のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
ALGA_TENANT_ID 任意。Alga サポートから指定されない限り空欄のままにしてください。誤った値を設定すると、すべてのリクエストが失敗します。 ALGA_TOOL_TIERS Comma-separated tool tiers. Every tool is read-only, so the only valid value is read (the default). The X-Conduit-Tool-Tiers request header can only narrow this set. · 初期値 read説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
Alga PSA のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (ALGA_INSTANCE_URL) · 先にパソコンへ Docker を入れてください(1 回だけ)
このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの VS Code に MCP server Alga PSA を入れてください。順番に:1) docker --version で Docker があるか確認。なければ https://www.docker.com/products/docker-desktop/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "alga-psa": { "type": "stdio", "command": "docker", "args": [ "run", "-i", "--rm", "-e", "ALGA_INSTANCE_URL", "-e", "ALGA_API_KEY", "ghcr.io/wyre-ai/alga-psa-mcp:v1.0.0" ], "env": { "ALGA_INSTANCE_URL": "your-value", "ALGA_API_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) ALGA_API_KEY, ALGA_INSTANCE_URL は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Alga PSA のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
docker --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: Docker Desktop を入れます:Mac は Docker.dmg を開いてアイコンを「アプリケーション」へドラッグ(Mac に合わせて Apple silicon か Intel を選ぶ)· Windows は Docker Desktop Installer.exe をダブルクリック · 入れたら Docker Desktop アプリを開いたままにします。curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: docker --version
一度入れれば、Docker を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
ALGA_INSTANCE_URL The https:// address you use to sign in to Alga, for example https://psa.example.com. A trailing / or /api/v1 is fine; leave off any other path. Works for Nine Minds–hosted and self-hosted instances.…説明は英語の原文のままです。
Alga PSA の設定で ALGA_API_KEY, ALGA_INSTANCE_URL が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Alga PSA を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が Alga PSA を使っていると言うか、回答に Alga PSA のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
ALGA_TENANT_ID 任意。Alga サポートから指定されない限り空欄のままにしてください。誤った値を設定すると、すべてのリクエストが失敗します。 ALGA_TOOL_TIERS Comma-separated tool tiers. Every tool is read-only, so the only valid value is read (the default). The X-Conduit-Tool-Tiers request header can only narrow this set. · 初期値 read説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください
JSON 設定は下の「開発者向け」にあります
Claude Code
claude mcp add --scope user alga-psa --env ALGA_INSTANCE_URL=your-value --env ALGA_API_KEY=your-value -- docker run -i --rm -e ALGA_INSTANCE_URL -e ALGA_API_KEY ghcr.io/wyre-ai/alga-psa-mcp:v1.0.0Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"alga-psa": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ALGA_INSTANCE_URL",
"-e",
"ALGA_API_KEY",
"ghcr.io/wyre-ai/alga-psa-mcp:v1.0.0"
],
"env": {
"ALGA_INSTANCE_URL": "your-value",
"ALGA_API_KEY": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"alga-psa": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ALGA_INSTANCE_URL",
"-e",
"ALGA_API_KEY",
"ghcr.io/wyre-ai/alga-psa-mcp:v1.0.0"
],
"env": {
"ALGA_INSTANCE_URL": "your-value",
"ALGA_API_KEY": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"alga-psa": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ALGA_INSTANCE_URL",
"-e",
"ALGA_API_KEY",
"ghcr.io/wyre-ai/alga-psa-mcp:v1.0.0"
],
"env": {
"ALGA_INSTANCE_URL": "your-value",
"ALGA_API_KEY": "your-value"
}
}
}
}ALGA_INSTANCE_URL 必須 envALGA_API_KEY 秘密 必須 envALGA_TENANT_ID envALGA_TOOL_TIERS env説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック
レジストリ名は、リポジトリを所有するGitHubアカウント WYRE-AI で確認済みです
コードの最終更新:3 日前
Apache-2.0を使用
これはパソコンで動くため、インターネット上のエンドポイントはありません
パソコンで動き、代わりにローカルの設定を使います
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/wyre-ai-alga-psa-mcp)質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
まだレビューはありません
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
入力が必要なもの:ALGA_API_KEY
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
GitHubリポジトリの最終更新は3 日前、最新バージョン(1.0.0)がレジストリに届いたのは9 日前です。
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにDockerも必要です。
同じカテゴリには:World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Manage monitors, status pages, incidents and maintenances in your openstatus workspace.
Validate oh-my-posh configurations and segment snippets against the official schema.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.
| これ Alga PSA | World Monitor | openstatus | Oh My Posh Validator | Strata | Jitsu | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 |
| キーが必要 | はい | いいえ | いいえ | いいえ | いいえ | いいえ |
| Claude で + から追加 | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ |
| 基本チェック | 3/3 | 4/4 | 4/4 | 4/4 | 1/4 | 4/4 |
| ライセンス | Apache-2.0 | AGPL-3.0 | AGPL-3.0 | MIT | Apache-2.0 | MIT |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
A read-only Apache-2.0 MCP server for Alga PSA, maintained by WYRE AI. It exposes 42 curated, hand-written read tools over stdio or stateless Streamable HTTP. Every tool is a plain GET in the read tier; the server ships no tool that creates, changes or deletes anything in Alga, and its HTTP client cannot send any other method or a request body.
The tools and schemas in this repository are hand-written. No generated API specification or Alga implementation code is included.
ai-assistant.The server only reads, but Alga's role permissions still decide which records the user can see, so keep the role read-only too.
The REST client targets {instance-origin}/api/v1. Supply an origin such as https://psa.example.com or https://psa.example.com:8443, with an optional /api/v1 suffix (normalized to the origin), and no other path, userinfo, query or fragment.
AUTH_MODE defaults to gateway for HTTP (unset or empty means gateway), and only gateway or env is accepted; any other value refuses to start. Send these headers on every request to /mcp:
| Header | Required | Meaning |
|---|---|---|
X-Alga-Instance-Url | Yes | The https:// address you use to sign in to Alga, for example https://psa.example.com. A trailing / or /api/v1 is fine; leave off any other path. Works for Nine Minds–hosted and self-hosted instances. Self-hosted instances on a public https:// URL are supported; instances on private networks are not. |
X-Alga-Api-Key | Yes | API key for the Alga user this connection acts as. Create it in Alga under Profile → API Keys. The key gets that user's permissions, so use a dedicated user with a limited role. |
X-Alga-Tenant-Id | No | Optional. Leave blank unless Alga support asks for it. A wrong value makes every request fail. |
X-Gateway-S2S | Yes, except insecure local dev | Timestamped gateway proof |
X-Conduit-Tool-Tiers | No | Comma-separated tiers for this request. read is the only tier this server has. The header only narrows the tiers the container serves and never widens them. Absent means no narrowing; present but empty (or naming no served tier) means no tools at all. |
Gateway mode never falls back to environment credentials, including the tenant ID. Missing required credential headers return HTTP 401 JSON {error: ...}; invalid or disallowed instance URLs return HTTP 400 JSON before MCP handling. A tenant ID, when supplied, must be a UUID. Empty tenant values are ignored. Credentials are isolated using AsyncLocalStorage. Each request gets its own MCP server and stateless transport; no credential-bearing sessions persist. /mcp accepts only POST: after the S2S check, any other method (including a GET for a standalone SSE stream, or DELETE) gets HTTP 405 with Allow: POST.
Set a real CONDUIT_S2S_SECRET of at least 32 characters to start HTTP (generate one with openssl rand -hex 32). The gateway proof has the form t= ,v1= , signing the literal t= with the configured secret. Proofs outside a five-minute window are refused. Deploy the vendor-specific derived S2S secret, not a shared gateway master secret. Empty or shorter secrets fail startup, and common placeholders such as changeme, secret and replace-with-a-real-secret are refused even in insecure dev mode. Values that look like a placeholder, repeat a short pattern (aaaa…, abcabc…) or use fewer than 8 distinct characters are refused too. The secret is never echoed in these errors.
GET /health is unauthenticated process liveness. It returns no credentials and never queries Alga. All /mcp requests require S2S before credential extraction or body-size handling. HTTP has no browser CORS allowance; use a trusted gateway.
Stdio always uses environment credentials. For standalone HTTP, set AUTH_MODE=env; HTTP still requires S2S unless insecure development is enabled. In AUTH_MODE=env, HTTP refuses to start unless ALGA_INSTANCE_URL is a valid instance URL and ALGA_API_KEY is set. The server does not automatically load .env files.
| Variable | Default | Purpose |
|---|---|---|
ALGA_INSTANCE_URL | Required in standalone | The https:// address you use to sign in to Alga, for example https://psa.example.com. A trailing / or /api/v1 is fine; leave off any other path. Works for Nine Minds–hosted and self-hosted instances. Self-hosted instances on a public https:// URL are supported; instances on private networks are not. |
ALGA_API_KEY | Required in standalone | API key for the Alga user this connection acts as. Create it in Alga under Profile → API Keys. The key gets that user's permissions, so use a dedicated user with a limited role. |
ALGA_TENANT_ID | Unset | Optional. Leave blank unless Alga support asks for it. A wrong value makes every request fail. |
AUTH_MODE | HTTP: gateway; stdio: env credentials | HTTP only: gateway or env, anything else refuses to start. Stdio always uses env credentials |
MCP_TRANSPORT | stdio (Docker: http) | Transport when using the HTTP entry point |
MCP_HTTP_PORT | 8080 | HTTP listener port |
MCP_HTTP_HOST | 0.0.0.0 with S2S | Bind host; insecure dev forces 127.0.0.1 |
MCP_ALLOWED_HOSTS | Unset (insecure dev: loopback names) | Optional comma-separated Host header allowlist for /mcp (with or without port); any other Host gets 403. Unset accepts any Host, except in insecure dev, where only 127.0.0.1, localhost and [::1] are accepted, so a DNS-rebinding page cannot reach it |
LOG_LEVEL | info | debug, info, warn, error; logs use stderr |
| Variable | Default | Behavior |
|---|---|---|
ALGA_TOOL_TIERS | read | Comma-separated tiers the container serves (the fleet's _TOOL_TIERS contract). read is the only valid value; anything else refuses to start |
ALGA_ALLOW_PRIVATE_INSTANCE | Off | Exactly true allows private/loopback destinations and HTTP, for stdio and AUTH_MODE=env sandboxes only. HTTP refuses to start with it in AUTH_MODE=gateway, and gateway mode never honours it |
CONDUIT_S2S_SECRET | Unset | Required for HTTP, at least 32 characters; never sent to Alga |
MCP_ALLOW_INSECURE_DEV | Off | Exactly 1 permits HTTP without S2S only on loopback, and only with NODE_ENV=development (any other non-empty value other than 0 or false refuses to start without it); cannot bypass placeholder refusal |
A tool removed for one requ