Obelinf

Obelinf MCP Server

Obelinf のネットワークおよびインフラストラクチャ文書化プラットフォーム向け、ホスト型の Model Context Protocol サーバーです。Claude、Cursor、Codex などの AI エージェントをインフラストラクチャの記録に接続し、1 つのエンドポイントを通じて、サイト、ラック、デバイス、IP アドレス空間、ケーブル配線を検索、質問、更新できるようにします。

このリポジトリにはサーバーのソースコードは含まれていません。MCP の掲載メタデータ、接続ドキュメント、MCP 機能の変更履歴、および公開課題トラッカーが含まれています。

• ウェブサイト：https://obelinf.com
• API ドキュメント：https://obelinf.com/docs/api/
• MCP 機能の概要：https://obelinf.com/features/ai-infrastructure-documentation/

クイックスタート

1. obelinf.com にサインインし、組織を開きます。MCP は無料の Personal プランを含むすべてのプランで利用できます。
2. API キーを作成します：ダッシュボード → API Keys → キーを作成し、スコープとして Read Only または Full Access を選択します。表示されたらコピーしてください。キーが表示されるのは一度だけです。
3. MCP クライアントにサーバーを追加します。エンドポイントは https://api.obelinf.com/mcp です。組織は、認証済みの Obelinf アカウントから選択されます。

ChatGPT

ChatGPT は OAuth を使用します。MCP エンドポイントを追加し、プロンプトが表示されたら Obelinf の承認フローを完了してください。Obelinf のサインイン方法は引き続き Google と GitHub を利用できます。承認後、ChatGPT には有効期間が短い、組織スコープ付きの MCP トークンが発行されます。

Cursor（プラグイン）

Cursor directory から Obelinf/mcp リポジトリを Cursor プラグインとしてインストールします。Plugins → Configure で OBELINF_API_KEY を一度設定すると、サーバーは自動的に接続されます。JSON を手動で編集する必要はありません。

代わりに手動で追加する場合は、以下の設定を使用してください。

Claude Code

claude mcp add --transport http obelinf "https://api.obelinf.com/mcp" \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop、Cursor、その他の JSON 設定対応クライアント

{
  "mcpServers": {
    "obelinf": {
      "url": "https://api.obelinf.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code（.vscode/mcp.json）

{
  "servers": {
    "obelinf": {
      "type": "http",
      "url": "https://api.obelinf.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

その他の MCP クライアントでは、上記の URL に Streamable HTTP で接続し、Authorization: Bearer ヘッダーで API キーを送信してください。

エンドポイントの詳細

プロパティ	値
エンドポイント	https://api.obelinf.com/mcp
トランスポート	MCP Streamable HTTP
認証	ChatGPT は OAuth、その他のクライアントはスコープ付き API キー
レート制限	1 分あたり 100 リクエスト
利用可能プラン	すべてのプラン
ツール	52

ツール

グループ	ツール	説明
検索	search	インベントリ全体のリソース横断型全文検索
サイト	list_sites, get_site, create_site, update_site, delete_site	物理的な拠点とデータセンターのサイト
ラック	list_racks, get_rack, create_rack, update_rack, delete_rack	ラックのインベントリ、ユニット、位置
デバイス	list_devices, get_device, create_device, update_device, delete_device	サーバー、スイッチ、アプライアンス、VM
サブネット	list_subnets, get_subnet, create_subnet, update_subnet, delete_subnet	IPAM のサブネットとプレフィックス
IP アドレス	list_ip_addresses, get_ip_address, create_ip_address, update_ip_address, delete_ip_address	割り当て済みアドレスと空きアドレス
VLAN	list_vlans, get_vlan, create_vlan, update_vlan, delete_vlan	VLAN グループと ID
VRF	list_vrfs, get_vrf, create_vrf, update_vrf, delete_vrf	仮想ルーティングおよびフォワーディングのインスタンス
ケーブル	list_cables, get_cable, create_cable, update_cable, delete_cable	ポートとエンドポイント間のケーブル配線
MAC アドレス	list_mac_addresses, get_mac_address, create_mac_address, update_mac_address, delete_mac_address	MAC アドレスのインベントリと割り当て
連絡先	list_contacts, get_contact, create_contact, update_contact, delete_contact	インフラストラクチャに関連付けられた人物とベンダー
変更履歴	list_changelog	変更者とフィールド単位の差分を含む、すべての変更の監査証跡

アクセス権限

• 読み取り専用キーでは、すべての読み取りツールと検索ツールを使用できます。書き込みツールを使用するとエラーが返されます。
• フルアクセスキーでは、読み取りと書き込みの両方が可能です。すべての書き込みは、実行者の情報とフィールド単位の差分とともに組織の変更履歴に記録されるため、エージェントによる編集も手動での編集と同様に確認できます。

エージェントは読み取り専用キーで開始し、差分を確認してから、慎重にフルアクセスへ昇格させてください。

サポート

• MCP インターフェースに関するバグ報告や機能リクエスト：イシューを作成
• プラン、料金、エンタープライズ契約について：営業に問い合わせる