はじめに

obniz MCP Server は、MCP 対応の AI クライアントから obniz Cloud 経由で obniz デバイスを操作するためのサーバーです。

MCP は Model Context Protocol の略で、AI クライアントが外部システムへ接続するための標準的な仕組みです。obniz MCP Server を使うと、AI クライアント側に obniz 専用の制御コードを組み込まずに、会話の中からデバイス操作を依頼できます。

仕組み

1
AI Client

Claude Desktop、Claude Code、Codex などの MCP 対応クライアント。

2
MCP Server

リクエストを受け取り、App Token に紐づく Hosted App へ接続します。

3
obniz Device

obniz Cloud 経由で実際のハードウェアを操作します。

  1. Claude Desktop や Claude Code などの AI クライアントが obniz MCP Server に接続します。
  2. クライアントは Authorization ヘッダーで App Token を送ります。
  3. MCP サーバーは App Token を使い、obniz Cloud 上の Hosted App にインストールされたデバイスへアクセスします。
  4. 対象の obniz デバイスは obniz Cloud 経由で操作されます。

利用シーン

次のような場合に利用できます。

  • AI アシスタントから obniz デバイスを操作したい
  • チャット形式の作業フローからデバイス状態を確認したい
  • 専用の制御プログラムを書く前にハードウェアの動作を試したい
  • 既存の obniz Cloud 環境へ MCP 対応クライアントから接続したい

前提条件

  • obniz Cloud アカウント
  • obniz Cloud 上の Hosted App
  • Hosted App の App Token
  • Hosted App にインストール済みの obniz デバイス
  • MCP 対応の AI クライアント

まずは クイックスタート でクラウド MCP エンドポイントへ接続してください。