● コミュニティ
maton-ai
⚡ 即起動
api-gateway-skill
作者 maton-ai · maton-ai/api-gateway-skill
1つのAPIキーでSlack、HubSpot、Salesforce、Google Workspace、Shopifyなど多数のサービスに接続できます。Matonのマネージド認証ゲートウェイをClaudeスキルとしてラップしたものです。
8つのSaaSベンダーそれぞれにOAuthアプリを登録する代わりに、1つのMaton APIキーを取得するだけで、Claudeがゲートウェイ経由ですべてのサービスを呼び出せます。Matonがトークンのリフレッシュ、スコープ、ベンダー固有の挙動を処理するため、ワークフローに集中できます。
なぜ使うのか
主な機能
- 1つのAPIキーで50以上のSaaS APIに対応
- マネージドOAuth — ベンダーごとのアプリ登録不要
- トークンリフレッシュをサーバーサイドで処理
- ベンダー間で統一されたエラー形式
- 一元管理で取り消し可能なスコープ付き権限
ライブデモ
実際の動作
api-gateway-skill.replay
▶ 準備完了
ユースケース
実用的な使い方: api-gateway-skill
使うタイミング: HubSpotにログインせずに、毎日「パイプラインで何が動いたか」を把握したいとき。
フロー
-
HubSpotにクエリ
Use api-gateway-skill. Pull deals updated today with a stage change in HubSpot. Include owner, amount, new stage.✓ コピーしました
→ 変更のある案件の構造化リスト
-
Slack向けにフォーマット
Summarize into a 5-line Slack message celebrating wins and flagging at-risk deals.✓ コピーしました
→ Slack形式のマークダウン
-
投稿
Post to #sales-daily.✓ コピーしました
→ メッセージ投稿完了、リンクが返される
結果: 3つのツール間でコピペすることなく、デイリーサマリーが投稿されます。
注意点
- パイプラインに動きがない日に不要な投稿をしてしまう — ステージ変更がゼロの日は投稿をスキップするようClaudeに指示する
使うタイミング: Shopifyアプリをインストールせずに、毎日自動更新されるシートが欲しいとき。
フロー
-
注文を取得
Use api-gateway-skill. Pull yesterday's Shopify orders with SKU, quantity, customer, country.✓ コピーしました
→ 注文の配列
-
シートに追記
Append as new rows to 'Orders 2026' sheet.✓ コピーしました
→ 行数が返される
結果: 自動的に蓄積される注文ログが完成します。
注意点
- ブラックフライデー時のレート制限 — Shopifyのカーソルでページネーションする。Matonがカーソルを公開しています
使うタイミング: 画面を切り替えることなく、複数ソースから顧客コンテキストを取得したいとき。
フロー
-
対象リードのSlackスレッドを検索
Use api-gateway-skill. Lead: ACME Corp. Find Slack messages in #cs-acme from the last 30 days mentioning them.✓ コピーしました
→ タイムスタンプとスニペット付きのスレッド
-
要約してSalesforceに書き戻す
Summarize into a 3-bullet note and append to the ACME account in Salesforce.✓ コピーしました
→ SFDCノートが作成される
結果: 手動コピーなしで、両方のツールにコンテキストが残ります。
注意点
- プライベートチャンネルが検索対象外になる — MatonのSlackアプリが該当チャンネルに招待されていることを確認する
組み合わせ
他のMCPと組み合わせて10倍の力を
Maton接続済みシステムとAirtableのソースオブトゥルース間を同期する
Mirror HubSpot deals into the 'Pipeline' Airtable base.✓ コピーしました
コストと制限
運用コスト
- APIクォータ
- Matonプランに準拠 — 有料プランでは通常1日あたり数千コール
- 呼び出しあたりのトークン
- ベンダーコールあたり200〜500トークン
- 金額
- Matonには無料プランあり。有料プランはコール数に応じてスケール
- ヒント
- 可能な限り読み取りをバッチ処理してください。各コールがカウントされます。
セキュリティ
権限、シークレット、影響範囲
最小スコープ: Vary per vendor — scoped to what you connect
認証情報の保管: Maton APIキーを環境変数に保存(例: MATON_API_KEY)。ベンダートークンはMatonがサーバーサイドで管理
データ送信先: MatonのAPIを経由し、接続先ベンダーへ送信
絶対に付与しない: Admin scopes you don't need
- MatonをOAuthブローカーとして信頼することになります。本番システムを接続する前に、MatonのセキュリティドキュメントとSOC2への対応状況を確認してください。
- Maton APIキーは定期的にローテーションしてください。不要になったベンダー接続はMatonダッシュボードから取り消してください。
トラブルシューティング
よくあるエラーと対処法
`gateway_call`からの401エラー
Maton APIキーが間違っているか期限切れです。Matonダッシュボードで再生成してください
確認: curl -H "Authorization: Bearer $MATON_API_KEY" https://api.maton.ai/v1/connections
ベンダー固有のエラーがそのまま返される
Matonはベンダーのエラーをそのまま透過します。該当ベンダーのドキュメントでエラーコードを確認してください
接続にスコープが不足している
Maton UIでベンダーを再接続し、必要なスコープを付与してください
代替案
api-gateway-skill 他との比較
| 代替案 | 代わりに使う場面 | トレードオフ |
| Direct vendor MCPs (slack, hubspot, salesforce) | 1〜2ベンダーしか必要ない場合 | OAuthを自分で管理する必要があるが、ゲートウェイへの依存がない |
| Zapier / Make | AI不要の自動化、ポイント&クリック操作 | LLMがワークフローに組み込まれない |