连接器

连接器把你的应用连接到你已有的服务：用 Stripe 收款，用 OpenAI 做 AI，用 Resend 发邮件，用 Google Sheets 管数据。你在自己的账户上连接一次，你选择的每个应用都可以使用它。连接器有六十多个，涵盖支付和商店，也涵盖 CRM、日历、AI 和设计工具。

每个应用本身就有自己的数据库、登录和邮件，不需要连接任何东西：这就是列表最上面的 Cloud，它是内置的，始终开启。连接器是为来自外部的东西准备的。

在哪里找到它们

• 在仪表盘或编辑器中：点击 +，然后点击 Connectors，选择这个应用可以使用哪些。
• 那个窗口底部的 Manage connectors 会打开 Connectors 页面本身，服务就在那里连接。它会覆盖在编辑器或仪表盘之上打开，所以你不会丢失当前的位置。
• 在 Connectors 页面上，左侧的列表可以按 All、Enabled、Custom connectors、MCP servers 以及服务的类型筛选卡片，搜索框可以按名称查找服务。
• 右上角的 + 可以添加不在列表中的服务：用 Custom connector 自己描述它，或者用 Request a connector 向我们提出。MCP server 也在这里，它是给构建你应用的 AI 用的，而不是给应用用的。
• 在编辑器中，Manage，然后 Integrations，会显示这个应用可以使用什么。请见集成。

连接一个服务

在 Connectors 页面上打开这个服务。每个服务都会说明你的应用可以用它做什么，在有必要的地方说明它不做什么，以及你的应用在过去 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 token 调用它，这个 token 本来就是公开的，所以它的限制要在 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 的审核之前，它的页面会警告说这个应用还没有经过验证，并要求你输入“I accept the risk”才能继续。
• 服务密钥：在 HubSpot 中，打开 Development，然后 Keys，然后 Service keys，创建一个拥有联系人、公司、交易和工单的读写权限的密钥。把它粘贴到 Credentials 下。HubSpot 的密钥以 pat- 开头。

谁可以在已发布的应用中使用它：

• 所有人：你网站上的表单可以添加联系人或工单。
• 仅限你的团队：读取 CRM 并更改其中的任何内容。在 Manage，然后 Cloud，然后 Users 中标记哪些账户是你的团队。请见以团队方式协作。

要让应用在仍然可以读取你的交易的同时，无法更改它们，请在 Permissions 下关闭交易的 Change。

你自己的 Supabase

Supabase 是可选的：每个应用本来就有后端。当你想把某个应用的数据放进你自己的 Supabase 项目时，再连接它。

• Credentials：项目的地址和它的 anon key，后者本来就是公开的。service role key 是可选的。
• Creating the tables 下的 Connect Supabase account，让 Setherion 每次在 Manage，然后 Cloud 中点击那里的按钮时，在你的项目中创建应用所需的表。你在 Supabase 登录并批准。这个权限留在 Setherion 的服务器上，永远不会交给你发布的应用。没有它，这些表仍然在那里，你可以自己复制粘贴到 Supabase 中。

要把一个已经有数据的应用迁移到你自己的 Supabase，请见高级设置。

有哪些连接器

每一个连接器，按描述它们的页面分组。每个页面里每个服务都有一个下拉项：它的用途、它需要哪些密钥以及在哪里找到、该提出什么要求、它的开关，以及它的限制。

对于不在列表中的服务，请自己描述它：请见自定义连接器。如果只是某个应用需要的一个密钥，用密钥与机密就够了。

谁可以使用连接

你的密钥永远不会到达访客手中，所以已发布的应用会通过 Setherion 调用服务，由 Setherion 决定允许什么。

• 只开放应用所需的路径。 发送邮件的应用可以发送，但无法访问你的账户、你的密钥或你的域名。商店前台可以读取产品，但无法读取订单或客户。
• 发件人和账户是固定的。 应用不能选择与你保存的不同的发件地址、电话号码、日历或列表。
• 你的团队和你的访客是不同的。 对于 CRM，访客的表单可以留下一条线索，只有你的团队可以读取或更改任何内容。在 Manage，然后 Cloud，然后 Users 中标记你的团队。每个连接器的页面都会说明它的哪些操作是公开的。
• 任何会触达某个人或花钱的操作都有频率限制。 邮件、短信、聊天消息、注册和付款，对每位访客限制为每小时大约十次调用。读取你自己的数据则宽松得多。超出的应用会被告知稍后再试。
• 每日和每月各有一道保险上限。 一个应用每天可以对服务发起几千次调用，已发布应用的调用会使用集成积分。

在团队工作区中

在 Business 套餐中，Settings，然后 Connector settings，为团队工作区提供两种选择。第一项只有所有者或管理员可以更改，而出借只有所有者可以进行。

• 工作区的应用可以使用哪些连接器。 不被允许的连接器会被排除在每一次构建之外，不会往已发布的应用里放入任何密钥，对它的每一次调用都会被拒绝。
• 出借所有者的连接。 成员的应用可以使用所有者对某个服务的连接，而成员自己没有连接过这个服务。密钥留在我们的服务器上，永远不会到达成员手中。服务商会向所有者的账户计这些调用的费用，它们也会计入创建者的集成积分。

支付、商店和数据库永远不会被出借：它们的账户、收款和数据属于连接它们的人。请见工作区。

自定义连接器和 MCP 服务器

对于不在列表中的服务，请自己描述它：请见自定义连接器。要给构建你应用的 AI 提供它自己的工具，请添加一个 MCP 服务器。

须知

• 已发布的应用对已连接的服务发起一次调用，会使用一个集成积分。请见套餐与积分。你可以在用量下看到每个应用花了多少。
• 按用量向你收费的服务，比如 Resend、Twilio 或 OpenAI，会按它们自己的价格向你自己的账户收费。请在那里设置支出上限：Setherion 会限制应用调用的速度，这可以防止滥用，但无法为你的支出封顶。
• 当应用调用一个没有连接的服务时，Manage，然后 Integrations，会说明这一点，并带有 Add the key。
• 断开一个服务的连接，会让使用它的每个应用立刻无法再访问它。