同じデータ、同じ認証。開発方法に合わせて3つの連携方法を選べます。
用途に合ったインターフェースを選択してください。多くの連携では、問い合わせにREST API、イベントへの対応にWebhookを組み合わせます。AIアシスタントを利用する場合はMCPサーバーを追加してください。SDKへの依存、独自プロトコル、追加料金はありません。
3つの開発者向けインターフェース、1つのプリンター群
それぞれ異なる種類の課題を解決します。1つだけでも、3つすべてでも利用できます。ユーザーごとの権限モデル、データ形式、アカウントは共通です。
X-API-KEYヘッダーを1つ使用したHTTPS経由のJSON。
任意のURL、Discord、Slack、Teamsにイベントをプッシュします。
Claude、ChatGPTなどのAIアシスタント向けネイティブツールインターフェース。
開発者がSimplyPrintで実際に作っているもの
プリントファーム、学校、メイカースペース、OEMパートナー、連携サービスの提供元で見られる実際の利用パターン：
- カスタムジョブ受付：見積もりポータルやERPから、支払い済みの注文を/queue/AddItem経由でSimplyPrintのキューに直接追加し、プリント完了時にwebhookで通知を返せます。ShipStation、Shopify、独自の注文ポータルもこの方法で連携できます。
- 生産ダッシュボード：APIを定期的に照会し、プリンターのリアルタイムの状態、キュー内の件数、日々の処理量を表示する大型画面向けステータスボードやBIダッシュボードです。Webhookと組み合わせることで、繰り返しの照会なしに即時更新できます。
- Discord、Slack、Teamsへの連携：チャンネルのWebhook URLを貼り付け、チームに必要なイベントを選ぶと、各サービスに対応したメッセージを受信できます。コードを書かずに作業場の通知を設定できます。
- AIアシスタント: Claude、ChatGPT、GeminiをMCP経由で接続し、キュー項目の承認、在庫が少ないスプールの検索、前日のプリント履歴のわかりやすい英語での要約を任せられます。
- ハードウェア連携：新しいAutoPrintハードウェア（プレート交換機、押し出し装置、ベルト改造機）は、いくつかのgcodeスニペットとIntegrationクラスを使い、AutoPrint連携フレームワークを通じて接続できます。
- ホワイトラベル展開：OEMパートナーは同じAPIを使い、SimplyPrintを基盤として自社ブランドの顧客向けサービスを提供できます。
サードパーティーのアプリとプラットフォーム向けOAuth2
SimplyPrintの顧客が自身のアカウントに接続する製品を開発する場合は、顧客にAPIキーの貼り付けを求める代わりにOAuth2を使用できます。顧客はSimplyPrintを接続をクリックし、simplyprint.ioにログインして、要求されたスコープの一覧を確認したうえで承認します。選択されたアカウントに紐づくベアラートークンを取得できるため、共有シークレットや認証情報のコピー＆ペースト、APIキーの紛失に関するサポート対応は不要です。
これは、Zapier、n8n、Make、Activepiecesなどのプラットフォーム向けに提供しているパートナー連携と同じOAuth2フローです（ワークフローの自動化を参照）。正規URLは以下のとおりです。
- 認可：simplyprint.io/panel/oauth2/authorize
- トークン交換：simplyprint.io/api/0/oauth2/Token
- ディスカバリー: 交換後に/account/GetUserを呼び出して紐付けられたアカウントを特定し、/api/{companyId}/{endpoint}を使用します
カスタムAutoPrintハードウェア連携
プレート交換装置、押し出し機構、ベルト改造、パーツ回収装置など、プリント後の取り出しを自動化するハードウェアの連携には、SimplyPrintのAutoPrintフレームワークを使用できます。各ハードウェア連携は、独自のGcodeテンプレート、方式を表すenumケース、マーケティング用メタデータとMethodDefinitionを公開するIntegrationクラスを登録します。SimplyPrintはこのMethodDefinitionを使ってハードウェアを検出し、制御します。
対応機器にはChitu PlateCycler、JobOx、FarmLoop、SimplyPrint AutoPrintデバイスがあり、すべて同じ連携フレームワークで接続されています。ハードウェアメーカー、またはメーカーに代わるSimplyPrintがPHPクラス1つとGcodeスニペットを提供し、メソッドの検出、パネルUI、キューの受け渡し、終了時のgcode、造形物の押し出し除去の検出はフレームワークが処理します。AutoPrintの正式なメソッドとして提供するハードウェアを開発している場合は、[email protected]までご連絡ください。
プラン別の利用条件：各開発者向け機能を利用できる対象
3つの開発者向け機能はすべてSimplyPrintの標準プランに含まれています。開発者用の追加シート、呼び出しごとの課金、イベントごとの料金はありません。Free、Basic、Cloud Slicer、Filament Managerプランでは、開発者向け機能を利用できません。以下の機能はすべてPro以上で利用できます。
| 機能 / 制限 | 無料 | 基本 | Pro | プリントファーム | エンタープライズ | 学校 | クラウドスライサー | フィラメントマネージャー |
|---|---|---|---|---|---|---|---|---|
|
基本APIアクセス
Pro以上で利用できます。HTTPS経由のJSON通信に、1つのX-API-KEYヘッダーを使用します。プリンターの状態、キュー項目、ジョブ、フィラメント在庫、タグ、グループの読み取りと限定的な書き込みが可能です。1分あたりのリクエスト数はProで60件、Print FarmとSchoolで180件、Enterpriseで600件です。
|
||||||||
|
拡張API（読み書きの全機能）
プリントファーム以上のプランで利用できます。/queue/AddItemによるファイルのアップロード、プリントを開始するキューの変更、G-codeの直接送信、一括書き込み操作が可能になります。プランの高いレート制限が適用されます。
|
||||||||
|
Webhooks
プリントファーム以上のプランで利用できます。JSON、Discord、Slack、Microsoft Teamsに対応したマルチチャネルWebhookシステムです。60種類以上のイベント、任意のHMAC署名、配信ごとの履歴に対応します。Webhookごとや配信ごとの料金はなく、イベント数の上限もありません。
|
||||||||
|
AIアシスタント向けMCPサーバー
Pro以上で利用できます。Claude（claude.ai、Claude Desktop、Claude Code）、ChatGPT、Gemini、CursorなどのMCP対応アシスタントを接続し、自然言語でプリンター群を操作できます。OAuthに基づき、スコープでアクセスを制限します。呼び出しごとの料金はかかりません。アシスタント自体の利用料金は各提供元に支払います。
|
||||||||
|
Zapier、n8n、Make、Activepieces
Pro以上では、公式のOAuth2連携機能を利用できます。連携機能はアカウントのAPIプランに従うため、Print Farm以上では完全な書き込みアクセスが可能です。
|
プランについて詳しく確認しますか？
料金と機能の比較をすべて表示はじめに
用途に合ったインターフェースを選択して始めましょう：
- REST API：パネルにサインインし、アカウント設定 -> APIを開いてキーに名前を付け、コピーします。詳細なリファレンスはapidocs.simplyprint.ioで確認できます。ドキュメントを基にツールを開発するためのllms.txtファイルと、構造化されたapi/index.jsonカタログも含まれます。
- Webhooks：パネルでWebhooksページを開き、送信先のURL（任意のURL、またはDiscord / Slack / TeamsチャンネルのWebhook）を貼り付け、必要なイベントを選択します。テスト送信はワンクリックでできます。手順：Webhooks機能の詳細。
- MCP:AIアシスタントのカスタムコネクター / MCPサーバー設定にhttps://simplyprint.io/api/mcpを貼り付け、OAuthの同意画面で手続きを完了してから、アシスタントに質問してください。手順の詳細: MCP経由でSimplyPrintを任意のAIアシスタントに接続。
- MCPの検索とクライアントパッケージ:公式MCP RegistryでSimplyPrintを探すか、ClaudeプラグインまたはGemini CLI拡張機能をインストールできます。
- OAuth2パートナーアプリ：OAuth2クライアント申請フォームからクライアントを申請し、上記のURLをアプリに設定してください。
よくある質問
APIを使うにはどのプランが必要ですか？
APIにはバージョンがありますか？
レート制限の内容は何ですか？
APIキーを取得するには？
APIキーとOAuth2のどちらを使うべきですか？
API、Webhook、MCPの違い
公式SDKはありますか？
サンドボックスやテスト環境はありますか？
データは何らかのAIの学習に使われますか？
困ったときはどこでサポートを受けられますか？
設定ガイド
各機能のクライアント別の詳しい手順は、ヘルプデスクの開発者向けセクションにあります。APIキーの設定、Discord / Slack / TeamsのWebhook設定、Claude、ChatGPT、Gemini CLIのMCP設定を確認できます。