Conector について
Conectorは、AIエージェントから各種アプリに共通のMCPエンドポイント経由で接続する、セルフホスト可能なチーム向けゲートウェイです。認証情報を集約し、アプリ用ツール、エージェント設定、アクセス制御、監査ログを提供します。
主な機能
- 01アプリを一度接続してエージェントで利用
- 021,178アプリと1,416ツールに対応
- 03CLIまたは設定ファイルでエージェント接続
- 04個人用・共有接続
- 05認証情報の暗号化と監査ログ
活用シーン
- 01複数のエージェントから業務アプリを利用
- 02単一のパネルでエージェント接続を設定
- 03トークンを特定のアプリに制限
- 04監査ログでツール呼び出しを確認
MCP 対応
Conectorは接続済みアプリのAPIを、Streamable HTTPまたはstdio経由のMCPツールとして公開します。エージェントごとのトークン認証、またはローカルのstdioサーバーを利用できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
1,178個のアプリに一度接続するだけで、Claude、Codex、Cursor、Gemini CLI、GitHub Copilot、その他42種類のAIエージェントから利用できます。
セルフホスト可能なオープンソースです。認証情報は暗号化され、お客様自身のサーバーに保存されます。
クイックスタート · エージェント · アプリ · セキュリティ · アプリを追加 · 概要
Conectorを選ぶ理由
AIエージェントが使えるのは、アクセス可能なツールだけです。すべてのエージェントをすべてのアプリに接続するには、マシンごと、エージェントごとにAPIキー、OAuthアプリ、設定ファイルを管理しなければなりません。Conectorなら、これらすべてを1か所にまとめられます。
- WebパネルでサインインするかAPIキーを貼り付けて、アプリに一度だけ接続します。
- 1つのコマンドまたは設定スニペットで、Conectorをエージェントに追加します。
- Model Context Protocolを通じて、接続したすべてのアプリのツールを、すべてのエージェントが利用できます。
|
1,178 個のアプリ GitHub、Gmail、Google Drive、Notion、Slack、Linear、HubSpot、Salesforce、Stripe、Microsoft 365、Jira などに対応しています。 107 個はワンクリックで接続できます。その他は、API キー、ユーザー名とパスワード、または何も必要ありません。 |
1,416 個のツール すべてのアプリで、API 全体を利用できる認証済みの <app>_request ツールを使用できます。多くのアプリには、outlook_search_mail、jira_search、slack_send_message などの専用ツールも用意されています。
|
47 個のエージェント パネルには、各エージェント用の正確なコマンドまたは設定ファイルが、トークンが入力された状態で表示されます。 conector install <agent> を実行すると、自動で設定できます。
|
|
チーム向けに設計 管理者とメンバー、招待リンク、個人用および共有の接続、選択したアプリに限定したエージェントごとのトークンに対応しています。 |
プライバシーを重視した設計 認証情報は AES-256-GCM で暗号化され、対象のアプリにのみ送信されます。パネルは外部のスクリプト、フォント、画像を読み込みません。 |
簡単に実行 Node.js と 3 つの依存関係で実行するか、 docker compose up を 1 つ実行するだけです。すべてのツール呼び出しは監査ログに記録されます。
|
クイックスタート
Node.js 22 以降を使って、次のコマンドを 1 つ実行します。
npx conector start
npm からインストールした場合、Conector はデータを ~/.conector に保存します。恒久的にインストールするには、npm install -g conector を実行し、その後 conector start を実行します。
Docker の場合:
docker run -d --name conector -p 127.0.0.1:8790:8790 -v conector-data:/data ghcr.io/secra-solutions/conector
docker logs conector # shows the setup link
または、ソースから実行します。
git clone https://github.com/Secra-Solutions/Conector.git
cd Conector
npm install
npm start
初回起動時に、一度だけ使用できるセットアップリンクが表示されます。
Conector 0.1.0 listening on http://127.0.0.1:8790 — public URL http://localhost:8790
No users yet. Create the admin account at:
http://localhost:8790/setup?code=…
リンクを開いて管理者アカウントを作成し、次の手順に進みます。
- アプリ: アプリを選択して接続します。
- エージェントを接続: エージェントを選択し、トークンを作成をクリックして、コマンドまたはスニペットをコピーします。
- エージェントにアプリを使うよう依頼します。たとえば、「GitHub の未完了のプルリクエストを一覧表示してください」と指示します。
Docker Compose を使用する場合
リポジトリをクローンした状態で、次を実行します。
docker compose up -d
docker compose logs conector # shows the setup link
データ(ユーザー、トークン、暗号化された認証情報、マスターキー)は conector-data ボリュームに保存されます。compose ファイルがパネルに公開するのは 127.0.0.1:8790 のみです。amd64 および arm64 用のイメージは ghcr.io/secra-solutions/conector で公開されています。リリース用は latest と X.Y.Z、メインブランチ用は edge です。
エージェントを接続する
各エージェントは専用のアクセストークン(cnr_…)で認証し、Authorization: Bearer ヘッダーを付けて Streamable HTTP 経由で http://<server>/mcp と通信します。ローカル(stdio)サーバーしか起動できないエージェントでは、同梱のブリッジ bin/stdio-bridge.js(または conector stdio)を使用し、CONECTOR_URL と CONECTOR_TOKEN を設定します。依存関係がないため、Node.js がインストールされた任意のマシンにコピーできます。Conector がデータを保存するマシンでは、エージェントから conector mcp を起動することもできます。これにより、ウェブサーバーやトークンなしで、同じツールを stdio 経由で提供します。
すべてを 1 台のマシンで使いますか? npx conector start でパネルを起動し、アプリを接続して、ワンクリックで Conector をエディターに追加します。このボタンは npx -y conector mcp を追加します。このコマンドは ~/.conector にある同じデータを読み取るため、トークンを作成する必要はありません。
| エージェント | |
|---|---|
| CLI | Claude Code、Codex、Gemini CLI、OpenCode、Amp、goose、Qwen Code、Factory Droid、Devin CLI、TRAE CLI、Mistral Vibe、Kimi Code CLI、Grok Build、Hermes Agent、Auggie CLI、CodeBuddy Code、Qoder CLI、MiniMax Code、Cortex Code、Deep Agents、fast-agent、Stakpak、ZCode、Pi、Oh My Pi、Muse Code、Autohand Code、CodeWhale、crow-cli、DimCode、Gajae Code、Minion Code、Nova、Poolside、siGit Code、VT Code、GLM Agent、Corust Agent |
| エディター | Cursor、GitHub Copilot(VS Code)、Cline、Kilo Code、Kiro、Junie、Google Antigravity |
| デスクトップとウェブ | Claude Desktop、Hoplite |
| 未対応 | ChatGPT(MCP サーバーで OAuth が必要です)、Agoragentic、Dirac(MCP サーバーを追加する方法がありません) |
パネルで Connect agents を開き、エージェントを選んで Create a token をクリックします。または、サーバー上のターミナルから次を実行します。
npm link # makes the `conector` command available
conector agents # list the supported agents
conector install claude-code # runs `claude mcp add …` with a new token
conector install cursor --user [email protected]
conector install codex --dry-run # show what it would do
conector install は、エージェント独自の CLI がインストールされている場合はそれを使用します。それ以外の場合は、エージェントの JSON または TOML 設定ファイルに項目をマージし、.conector-backup のコピーを保持します。安全にマージできないファイル(JSONC のコメント、YAML、既存のテーブルなど)の場合は、貼り付け用のスニペットを表示します。
アプリ
各アプリのページには、接続するための最も簡単な方法が用意されています。
- Continue with …: OAuth サインインです。管理者は OAuth apps で、プロバイダーごとに Conector の OAuth アプリを一度登録します。ページには、使用するリダイレクト URI とスコープが表示されます。1 回の登録で、そのプロバイダーのすべてのアプリを利用できます。たとえば、Google の OAuth アプリ 1 つで Gmail、Drive、Calendar、Sheets などを利用できます。
- API キー、またはユーザー名とパスワード: キーの確認手順を順を追って説明し、保存時に接続テストを行います。
- Enable: 認証情報が不要な公開 API です。
- Microsoft 365: アプリの登録は不要で、デバイスコードを使ってサインインします。
接続は個人用(自分だけが使用)または共有(ワークスペースの全員が使用。作成できるのは管理者のみ)です。両方ある場合は、個人用の接続が優先されます。
設定
以下の環境変数を設定するか、package.json と同じ場所にある .env ファイルに記述してください(.env.example を参照)。Conector を npm からインストールした場合、.env ファイルは代わりにカレントディレクトリから読み込まれます。
| 変数 | デフォルト | |
|---|---|---|
CONECTOR_PORT | 8790 | リッスンするポートです。 |
CONECTOR_HOST | 127.0.0.1 | バインドするインターフェースです。ファイアウォールまたはリバースプロキシの背後にある場合に限り、0.0.0.0 を使用してください。 |
CONECTOR_PUBLIC_URL | http://localhost:<port> | ユーザーやエージェントが使用するアドレスです。一部の OAuth プロバイダーでは https:// が必要です。 |
CONECTOR_ALLOWED_HOSTS | 受け入れる追加の Host ヘッダーをカンマ区切りで指定します(例:conector.lan:8790)。 | |
CONECTOR_DATA_DIR | ./data | ユーザー、トークン、暗号化された認証情報、マスターキー、監査ログを保存します。npm からインストールした場合は ~/.conector、Docker では /data です。 |
CONECTOR_TRUST_PROXY | 同じマシンまたはプライベートネットワーク上のリバースプロキシの背後にある場合は 1 を指定します。 | |
CONECTOR_HSTS | 1 | 公開 URL が https:// の場合、Strict-Transport-Security を送信します。同じホスト名で別のポート上に HTTP サービスも公開している場合は 0 に設定してください。 |
CONECTOR_SESSION_HOURS | 12 | パネルのセッションが期限切れになるまでのアイドル時間です。サーバーの再起動時にもセッションは終了します。 |
CONECTOR_ALLOW_PRIVATE_HTTP | 1 にすると、ローカルネットワーク上のセルフホストアプリで http:// を使用できます(例:http://homeassistant.local:8123 や http://192.168.1.10:8123)。詳細は以下を参照してください。 |
他のマシンやクラウドエージェントから Conector に接続するには、HTTPS リバースプロキシまたはトンネル(Caddy、nginx、Cloudflare Tunnel…)を手前に配置し、CONECTOR_PUBLIC_URL をそのアドレスに設定してください。
セルフホストアプリでは、localhost を除き https:// を使用する必要があります。多くのホームサーバーには証明書がないため、CONECTOR_ALLOW_PRIVATE_HTTP=1 を設定すると、プライベートネットワークアドレスでも http:// を受け入れます。対象となるのは、10.x、172.16–31.x、192.168.x、100.64–127.x(Tailscale)、IPv6 のユニークローカルアドレス、*.local、*.lan、*.home.arpa、host.docker.internal、およびドットを含まない名前です。有効にする前に、次の 2 点に注意してください。これらのアプリの認証情報はネットワーク上で暗号化されずに送信されます。また、接続を作成できるユーザーは、Conector にネットワーク上の HTTP サービスを呼び出させることができます。クラウドメタデータアドレスは引き続きブロックされます。Docker では localhost はコンテナ自体を指します。ホストの LAN アドレスまたは host.docker.internal を使用してください。
ユーザーとセキュリティ
- ロール: 管理者はユーザー、OAuth アプリ、共有接続を管理します。メンバーは自身のアプリを接続し、共有アプリを使用します。招待リンクとパスワードリセットリンクは一度だけ使用でき、Conector からメールが送信されることはありません。
- トークンはユーザーとして動作し、一部のアプリに制限できます。トークンは一度だけ表示されます。Conector が保存するのは SHA-256 ハッシュのみです。
- パスワードは scrypt でハッシュ化され、12 文字以上である必要があります。サインインの失敗が繰り返されると、試行が制限されます。
- パネルは厳格な Content Security Policy を設定し、すべてのフォームで CSRF トークンとオリジンを確認します。既知の
Hostヘッダーのみを受け入れて DNS リバインディングを防ぎ、デフォルトでは127.0.0.1にバインドします。 - ユーザー入力から構築されるアプリ URL(サブドメイン、セルフホストのインスタンス)は検証されるため、認証情報が別のサーバーに送信されることはありません。
- 監査ログには、すべてのツール呼び出しとパネルでの変更が記録されます。リクエストのペイロードや認証情報が保存されることはありません。
CONECTOR_DATA_DIR をバックアップしてください。master.key がないと、保存された認証情報を復号できません。脆弱性の報告については、SECURITY.md を参照してください。
REST API
同じトークンをスクリプトや自動化にも使用できます。
curl -H "Authorization: Bearer $CONECTOR_TOKEN" http://localhost:8790/api/v1/apps
curl -H "Authorization: Bearer $CONECTOR_TOKEN" -H "Content-Type: application/json" \
-d '{"method":"GET","path":"/user"}' http://localhost:8790/api/v1/apps/github/request
コマンドライン
conector start Start the server
conector setup-link Print a link to create the first admin account
conector users | tokens List users or access tokens
conector invite <email> [--admin] Print an invitation link
conector reset-link <email> Print a password reset link
conector token <email> [--apps a,b] [--name N]
conector revoke <token id>
conector agents | install <agent> Add Conector to an agent
conector stdio stdio bridge for agents that only start local servers
conector mcp [--user <email>] MCP over stdio on this machine, without the web server or a token
conector apps [--connected] List the catalog
アプリの追加
アプリは、ベース URL、認証方法、接続テスト、ヘルプテキストからなる単純なデータです。完全な例:
{
id: "acme", name: "Acme", category: "productivity", description: "Projects and tasks in Acme",
website: "https://acme.example", docs: "https://developers.acme.example", logo: { favicon: "https://acme.example" },
baseUrl: "https://api.acme.example/v1",
fields: [{ id: "token", label: "API key", secret: true }],
auth: { type: "bearer" },
help: "1) In Acme open “Settings” → “API”. 2) Click “New key” and paste it here.",
test: { path: "/me", account: (d) => d.email },
}
docs/ADDING_APPS.md では、各オプション(OAuth、クライアント認証情報、AWS 署名、カスタムツール…)について説明しています。編集後、npm run validate を実行してください。
開発
npm run dev # restart on changes
npm test # unit and end-to-end tests
npm run validate # check every app definition (offline)
npm run validate:network # also call each app's API with fake credentials
npm run logos # regenerate app logos (npm run logos -- --agents for agents)
コードはプレーンな JavaScript(ES モジュール)で、実行時依存関係は Express、MCP SDK、Zod の 3 つです。ページはエスケープ処理を行うテンプレートタグを使ってサーバー側でレンダリングされます。ブラウザスクリプトは小規模なプレーンな JavaScript です。
bin/ conector CLI and the stdio bridge
src/ server, MCP, auth, encrypted store, OAuth
src/catalog app definitions (apps/*.js) and the engine that turns them into tools
src/ui pages, layout and icons
public/ CSS, JavaScript, fonts, brand and logos
scripts/ catalog validator and logo generator
test/ node:test suites
貢献
新しいアプリ、エージェントのインストールガイド、修正、アイデアを歓迎します。始めるにはCONTRIBUTING.mdをご覧ください。初めての方におすすめの課題(カタログにまだ掲載されていない人気のセルフホスト可能なアプリが多数あります)を選ぶか、ディスカッションでご相談ください。参加される皆さまには行動規範を遵守していただきます。
Secra Solutions 提供
Secra Solutions は Conector を開発・保守し、誰もが自分の AI エージェントから使用するツールへ安全にアクセスできるよう、オープンソースとして公開しています。
Conector は、コミュニティ向けの当社初のオープンソースの取り組みです。役に立ったと思われたら、今後も取り組みを続けられるよう、リポジトリにスターを付ける、課題を登録する、プルリクエストを送るなどして、次に開発してほしいものをお知らせください。
クレジット
- Composioに着想を得ています。
- Geist フォント(SIL Open Font License 1.1)、Phosphor アイコン(MIT)、Simple Icons のブランドグリフ(CC0)。
- アプリ名、エージェント名、ロゴは、それぞれの所有者の商標です。各サービスを識別する目的でのみ表示しており、推奨を意味するものではありません。
ライセンス
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。
