コネクタ

コネクタは、すでにお持ちのサービスとアプリをつなぎます。決済ならStripe、AIならOpenAI、メールならResend、データならGoogle Sheetsといったものです。アカウントで一度接続すれば、選んだアプリのすべてがそれを使えます。決済やショップから、CRM、カレンダー、AI、デザインのツールまで、60以上あります。

どのアプリにも、接続しなくても、最初から専用のデータベース、ログイン、メールがあります。それが一覧の一番上にあるCloudで、標準で組み込まれ、常にオンです。コネクタは、外部から来るもののためにあります。

見つける場所

• ダッシュボードまたはエディタで、「+」、Connectorsの順に開くと、このアプリが使えるものを選べます。
• そのウィンドウの下にあるManage connectorsで、サービスを接続するConnectorsページ自体が開きます。エディタやダッシュボードの上に開くので、今の場所を失いません。
• Connectorsページでは、左側の一覧で、All、Enabled、Custom connectors、MCP servers、サービスの種類によってタイルを絞り込めます。検索ボックスでは、名前でサービスを探せます。
• 右上の「+」では、一覧にないものを追加できます。Custom connectorで自分で説明するか、Request a connectorでこちらにリクエストできます。MCP serverもここにあり、アプリのためではなく、アプリを作るAIのためのものです。
• エディタでは、Manage、Integrationsの順に開くと、このアプリが使えるものが表示されます。連携をご覧ください。

サービスを接続する

ConnectorsページでそのサービスをOpenします。それぞれのページには、アプリがそれで何をできるか、重要な場合は何をしないか、過去30日間にあなたのアプリがどれだけ使ったかが書かれています。入口は二つあり、サービスにサインインするか、サービスから渡されたキーを貼り付けるかです。Connectorsページには、それぞれのサービスにあるほうが表示されます。両方あるサービスもあり、その場合、ページにはSign in with the service, or add your own keys insteadと表示されます。

ボタンを使う方法。Stripe、Notion、Google Sheets、Airtable、Slack、Discord、Calendly、Google Calendar、Microsoft 365、HubSpot、Pipedrive、Zoho CRM、Zoho Books、Salesforce、Linear、Asana、Atlassian（JiraとConfluence）、Figma、Canva、GitHub、GitLabは、そのサービスにログインして戻ってくるだけで接続できます。キーを見たりコピーしたりすることはありません。StripeのボタンはSet up Stripeです。オンラインストアをご覧ください。Salesforceでは、最初のログインの前に、管理者がSetherionのパッケージを一度インストールする必要があります。

キーを使う方法。そのほかのサービスでは、サービスから受け取ったキーをCredentialsの下に貼り付けます。「Where do I find these?」を押すと、そのサービスの正しいページが開き、各ボックスには、どのキーが必要かを正確に示すヒントがあります。Test connectionは、実際に使う前にキーを試し、Connectはキーを保存します。接続後は、Updateでキーを変更し、Removeで削除できます。Connectが灰色の場合は、空のボックスがあるか、サービスの利用規約を理解したことを示す行にまだチェックを入れていません。Take me thereを押すと、そこへ移動します。

接続したサービスは、タイルに緑の点が付き、名前の横にEnabledと表示されます。最初の接続の前に、各サービスが自分にとってどういう意味を持つかを平易な言葉で伝え、あなたは理解したことにチェックを入れます。バッジが要点を示します。使った分をサービスが請求する場合はBilled by（たとえばBilled by Supabase）、決済とショップにはHandles real money、そのほかにはNo usage chargesです。

Connectのあとの次のステップ

ページでサービスを接続した直後に、Stripe is connected. Next: use it in this appというカードが表示されます。ダッシュボードから来た場合は、build an app with itと表示されます。そのボタンのUse in this appまたはBuild an app with itを押すと、チャットに最初の依頼が書き込まれ、サービスがアプリの一覧に加わります。たとえば、「このアプリでStripeを使う：オンライン決済、サブスクリプション、請求書」のような依頼です。依頼はメッセージボックスで待機します。Sendを押すまで、何も作られず、何も使われません。カードは閉じられ、次回以降は表示されません。FigmaやGitHubのようなデザインとコードのサービスには、このカードはありません。アプリが使うものではなく、アプリを作るときに読み取られるものだからです。

サービスができないこと

サービスに明らかな制限がある場合は、そのページの灰色の注記で伝え、代わりにその役目を果たすコネクタへのボタンが付きます。PayPalがその例です。各ボタンで買えるのは一つの商品だけで、カートはなく、支払いがあってもアプリには通知されません。そのため、注記ではStripeとPaddleを案内しています。

使うアプリを選ぶ

サービスを接続しても、すべてのアプリに入るわけではありません。アプリで「+」、Connectorsの順に開き、このアプリが使えるものにチェックを入れて、Doneを押します。チェックしなかったものは、アプリのコードにもキーにも入りません。まだ接続していないサービスには、横にConnectがあり、そのサービスのページに移動します。

そのあと、チャットで何をさせたいかを頼みます。

先にチェックを入れる必要はありません。メッセージに、アプリがまだ使えないサービスの名前が含まれていると、メッセージボックスの上のバーにThis needs Stripeと表示され、三つの選択肢が出ます。すでに接続済みならUse it here、キーまたはサービス自身のログインでその場で接続するConnect、そしてBuild without itです。それなしで進めると、アプリは機能が動くふりをせず、その機能は未設定だと表示します。

権限

一部のサービスでは、接続後にそのページのPermissionsの下に、アプリが何をできるかが一覧で表示されます。各行にはボタンが二つあります。チェックマークは許可、斜線の入った丸はオフにします。

• 変更は押した時点で保存され、その接続を使っているすべてのアプリに、公開済みのものも含めて、すぐに反映されます。
• オフにされたことを試したアプリには、そのことと、どこでオンに戻せるかを伝えるエラーが返ります。新しいビルドにはその旨が伝えられ、その機能は含まれません。
• サービスは、あなたのキーまたはログインに与えたすべての権限を、そのまま認めます。ここでの制限はSetherionが、それに加えて設けているものです。
• 接続を削除すると、すべてがオンに戻ります。

Shopifyは違います。あなたのアプリは、もともと公開される前提のStorefrontトークンを使って、ページから直接Shopifyを呼び出します。そのため制限はShopifyで設定します。Sales channels、Headless、あなたのストアフロントの順に開き、Storefront APIの横のManageを押して、Permissionsを編集します。Setherionのそのページにも、同じ手順が表示されます。

Supabase、Firebase、Google Maps、Cloudinaryも同じです。あなたのアプリはページから直接これらを呼び出すので、制限はそれぞれのサービスで設定します。Setherionのそれぞれのページに、その場所が書かれています。

ほかのサービスは、Permissionsの下に、あなたのアプリがそのサービスでできることをすべて一文で示します。たとえば、メールを送ることだけ、商品を読むことだけ、などです。Canva、Figma、GitHub、GitLabは、あなたのアプリがそれらを使うことはなく、エディターからあなたが使うだけだと示します。

HubSpot

HubSpotは、CRMをアプリに取り込みます。コンタクト、会社、取引、チケットです。接続の方法は二つあります。

• Connect with HubSpot：HubSpotでログインし、アカウントを選んで承認します。HubSpotがSetherionの審査を終えるまでは、HubSpotの画面で、アプリがまだ確認されていないという警告が表示され、先に進むには「I accept the risk」と入力するよう求められます。
• サービスキー：HubSpotでDevelopment、Keys、Service keysの順に開き、コンタクト、会社、取引、チケットの読み取りと書き込みを許可したキーを作成します。それをCredentialsの下に貼り付けます。HubSpotのキーはpat-で始まります。

公開したアプリで、誰が使えるか。

• 誰でも：サイトのフォームから、コンタクトやチケットを追加できます。
• チームのみ：CRMの読み取りと、その中のあらゆる変更です。Manage、Cloud、Usersの順に開いて、チームのアカウントに印を付けてください。チームでの作業をご覧ください。

アプリが取引を読み取れるまま、変更はできないようにするには、権限で取引のChangeをオフにします。

自分のSupabase

Supabaseは任意です。どのアプリにも、最初からバックエンドがあります。アプリのデータを自分のSupabaseプロジェクトに置きたいときに接続してください。

• Credentials：プロジェクトのアドレスと、もともと公開される前提のanon keyです。service role keyは任意です。
• Creating the tablesの下にあるConnect Supabase accountを使うと、Manage、Cloudで、そこのボタンを押すたびに、Setherionがアプリに必要なテーブルをあなたのプロジェクトに作成できます。Supabaseでログインして承認します。この権限はSetherionのサーバーに残り、公開したアプリに渡されることはありません。これがなくても、テーブルは用意されているので、自分でコピーしてSupabaseに貼り付けられます。

すでにデータがあるアプリを自分のSupabaseに移すには、詳細設定をご覧ください。

対応しているもの

すべてのコネクタを、それを説明するページごとにまとめています。各ページには、サービスごとに折りたたみが一つあり、何に使うか、どのキーが必要でどこにあるか、何を頼めるか、スイッチ、そして制限が書かれています。

一覧にないサービスは、自分で説明できます。カスタムコネクタをご覧ください。あるアプリが必要とするキーが一つだけなら、キーとシークレットで十分です。

接続を使えるのは誰か

あなたのキーが訪問者に届くことはありません。そのため、公開したアプリはSetherion経由でサービスを呼び出し、何が許可されるかはSetherionが決めます。

• アプリが必要とする経路だけ。メールを送るアプリは、送信はできますが、あなたのアカウント、キー、ドメインには触れられません。ショップのフロントは商品を読み取れますが、注文や顧客は読み取れません。
• 送信者とアカウントは固定です。アプリは、あなたが保存したものとは別のFromアドレス、電話番号、カレンダー、リストを選べません。
• チームと訪問者は別です。CRMの場合、訪問者のフォームはリードを残せますが、チームだけがあらゆるものを読み取り、変更できます。Manage、Cloud、Usersの順に開いて、チームに印を付けてください。どの操作が公開されているかは、各コネクタのページに書かれています。
• 人に届くものや費用がかかるものには、回数制限があります。メール、テキストメッセージ、チャットのメッセージ、新規登録、決済は、訪問者ごとに1時間あたり約10回の呼び出しに制限されます。自分のデータの読み取りは、はるかに多く許可されます。上限を超えたアプリには、あとでもう一度試すよう伝えられます。
• 1日と1か月の上限があります。一つのアプリがサービスを呼び出せるのは1日に数千回までで、公開したアプリの呼び出しには連携クレジットが使われます。

チームのワークスペースでは

Businessでは、Settings、Connector settingsの順に開くと、チームのワークスペースに二つの選択肢があります。最初の設定を変更できるのはオーナーまたは管理者だけで、貸し出しができるのはオーナーだけです。

• ワークスペースのアプリが使えるコネクタ。許可されていないコネクタは、すべてのビルドから外され、公開したアプリにキーを入れず、それへの呼び出しはすべて拒否されます。
• オーナーの接続の貸し出し。メンバーのアプリは、メンバー自身が接続していないサービスについて、オーナーの接続を使えます。キーはこちらのサーバーに残り、メンバーに届くことはありません。それらの呼び出しの料金は、提供元からオーナーのアカウントに請求され、作成者の連携クレジットとして数えられます。

決済、ショップ、データベースは貸し出されません。そのアカウント、支払い、データは、接続した人のものだからです。ワークスペースをご覧ください。

カスタムコネクタとMCPサーバー

一覧にないサービスは、自分で説明できます。カスタムコネクタをご覧ください。アプリを作るAIに専用のツールを持たせるには、MCPサーバーの追加をご覧ください。

知っておくと便利なこと

• 公開したアプリが接続済みのサービスを呼び出すと、連携クレジットが1つ使われます。クレジットをご覧ください。各アプリの使った量は、使用量で確認できます。
• Resend、Twilio、OpenAIのように利用に応じて請求されるサービスは、そのサービスの料金で、あなた自身のアカウントに請求します。そちらで支出の上限を設定してください。Setherionはアプリが呼び出せる速さを制限して不正利用を防ぎますが、あなたの支出に上限を設けることはできません。
• アプリが未接続のサービスを呼び出すと、Manage、Integrationsにそのことが表示され、Add the keyが付きます。
• サービスの接続を解除すると、それを使っているすべてのアプリが、すぐにそのサービスへ届かなくなります。