커넥터

커넥터는 이미 쓰고 있는 서비스와 내 앱을 이어 줘요. 결제는 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 페이지에서 서비스를 여세요. 서비스마다 앱이 그 서비스로 무엇을 할 수 있는지, 중요한 경우에는 무엇을 하지 않는지, 지난 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이 결정해요.

• 앱에 필요한 경로만. 이메일을 보내는 앱은 보낼 수 있지만, 내 계정, 키, 도메인에는 닿을 수 없어요. 쇼핑몰 프런트는 상품을 읽을 수 있지만 주문이나 고객은 읽을 수 없어요.
• 보내는 사람과 계정은 고정돼요. 앱은 내가 저장한 것과 다른 발신 주소, 전화번호, 캘린더, 목록을 고를 수 없어요.
• 팀과 방문자는 달라요. CRM의 경우 방문자의 폼은 리드를 남길 수 있고, 무엇이든 읽거나 바꿀 수 있는 건 팀뿐이에요. Manage, Cloud, Users 순서로 열어 내 팀에 표시하세요. 어떤 동작이 공개되어 있는지는 각 커넥터의 페이지에 나와 있어요.
• 사람에게 닿거나 돈이 드는 일에는 호출 횟수 제한이 있어요. 이메일, 문자, 채팅 메시지, 회원가입, 결제는 방문자 한 명당 한 시간에 약 10번까지 호출할 수 있어요. 내 데이터를 읽는 일은 훨씬 더 많이 허용돼요. 한도를 넘은 앱은 나중에 다시 시도하라는 안내를 받아요.
• 하루 한도와 한 달 한도가 있어요. 앱 하나가 하루에 서비스를 호출할 수 있는 횟수는 수천 번까지이고, 게시한 앱의 호출에는 연동 크레딧이 쓰여요.

팀 워크스페이스에서

Business 요금제에서는 Settings, Connector settings 순서로 열면 팀 워크스페이스에 두 가지 선택이 있어요. 첫 번째를 바꿀 수 있는 사람은 소유자나 관리자뿐이고, 빌려줄 수 있는 사람은 소유자뿐이에요.

• 워크스페이스의 앱이 쓸 수 있는 커넥터. 허용되지 않은 커넥터는 모든 빌드에서 빠지고, 게시한 앱에 키를 넣지 않으며, 그 커넥터에 대한 모든 호출이 거절돼요.
• 소유자의 연결 빌려주기. 멤버의 앱은 멤버가 직접 연결하지 않은 서비스에 대해 소유자의 연결을 쓸 수 있어요. 키는 저희 서버에 남고 멤버에게는 전달되지 않아요. 그 호출의 요금은 서비스 제공업체가 소유자의 계정에 청구하고, 만든 사람의 연동 크레딧으로 계산돼요.

결제, 쇼핑몰, 데이터베이스는 절대 빌려줄 수 없어요. 그 계정, 정산금, 데이터는 연결한 사람의 것이기 때문이에요. 워크스페이스를 참고하세요.

커스텀 커넥터와 MCP 서버

목록에 없는 서비스는 직접 설명할 수 있어요. 커스텀 커넥터를 참고하세요. 앱을 만드는 AI에게 전용 도구를 주려면 내 MCP 서버를 추가하세요.

알아 두면 좋은 점

• 게시한 앱이 연결된 서비스를 호출할 때마다 연동 크레딧이 1개 쓰여요. 크레딧을 참고하세요. 앱마다 얼마나 썼는지는 사용량에서 볼 수 있어요.
• Resend, Twilio, OpenAI처럼 사용한 만큼 요금을 청구하는 서비스는 그 서비스의 가격으로 내 계정에 직접 청구해요. 거기서 지출 한도를 설정하세요. Setherion은 앱이 호출할 수 있는 속도를 제한해 남용을 막지만, 내가 쓰는 금액에 상한을 둘 수는 없어요.
• 연결되지 않은 서비스를 앱이 호출하면, Manage, Integrations에 그 사실이 표시되고 Add the key가 함께 나와요.
• 서비스 연결을 해제하면, 그 서비스를 쓰던 모든 앱이 즉시 그 서비스에 닿지 못해요.