앱을 MCP 서버로 게시

게시된 Lovable 앱을 ChatGPT, Claude 등 AI 어시스턴트를 위한 MCP 서버로 전환합니다. 도구, 로그인, 권한, 접근을 구성합니다.

에이전트 통합(Agent integrations)은 게시된 Lovable 앱을 AI 어시스턴트에서 사용할 수 있게 만듭니다. 사용자는 ChatGPT, Claude 또는 호환되는 다른 어시스턴트에서 앱을 연결한 뒤 어시스턴트에게 정보 조회, 워크플로 실행, 레코드 생성·수정, 앱 로직 적용을 요청할 수 있습니다.

사람은 버튼을 클릭하고 폼을 작성하고 화면을 이동하며 앱을 사용합니다. AI 어시스턴트는 클릭할 수 없으므로 대신 호출할 수 있는 액션 목록이 필요합니다. 그 목록을 제공하는 것이 MCP 서버입니다.

Model Context Protocol, 줄여서 MCP는 AI 어시스턴트가 앱의 액션(도구라고 부름)을 발견하고 호출할 수 있게 하는 개방형 표준입니다. 사용자가 어시스턴트에게 앱이 처리하는 작업을 요청하면 어시스턴트가 알맞은 도구를 선택하고 앱이 실제 작업을 수행합니다.

Lovable이 MCP 서버를 생성하고 호스팅하며 주문 조회, 견적 생성, 지식 베이스 정보 검색처럼 앱 기능에 기반한 도구를 제안합니다. 사용자 입장에서 앱 연결은 플러그인 추가와 비슷하게 동작합니다. 어시스턴트는 게시한 도구에만 접근할 수 있고 Lovable 프로젝트 자체에는 접근할 수 없습니다.

동작 방식

공개 게시된 앱에서 통합을 활성화하면 Lovable이 다음을 수행합니다.

1. 앱을 위한 MCP 서버를 생성합니다.
2. 앱이 하는 일에 기반해 도구 세트를 제안합니다.
3. 도구를 호출할 수 있는 대상(로그인한 사용자 또는 누구나)을 묻습니다.
4. 답변에 맞춰 인증을 설정합니다.

제안된 도구는 출발점일 뿐입니다. 언제든지 Lovable에게 도구 추가·제거·이름 변경·수정을 요청할 수 있습니다.

무엇이든 라이브로 나가기 전에 도구와 접근 설정을 검토한 뒤 앱을 게시합니다. Lovable이 사용자에게 공유할 MCP 링크를 제공합니다. 사용자는 이 링크를 자신의 AI 어시스턴트에 커스텀 커넥터로 추가하고 앱이 요구하면 로그인한 뒤 어시스턴트에게 앱 사용을 요청하기 시작합니다.

통합은 복사본이 아니라 라이브로 게시된 앱에서 실행됩니다. 통합을 활성화하면 프로젝트에 도구 코드와 연결 엔드포인트가 추가되며 앱을 사용하는 사람에게는 아무것도 달라지지 않습니다. Lovable이 MCP 서버를 호스팅하고 표준이 발전해도 호환성을 유지합니다. 어떤 액션을 노출할지, 누가 호출할 수 있는지, 변경 사항을 언제 게시할지는 직접 제어합니다.

앱이나 도구를 변경하면 다시 게시하세요. 도구를 추가·제거하거나 이름을 바꾸면 사용자가 커넥터를 새로고침해야 합니다. 단계별 안내는 에이전트 통합 설정에 있습니다.

Lovable의 다른 MCP 기능과의 차이

Lovable은 MCP를 세 가지 방식으로 사용하며 각각 다른 시스템을 다른 목적으로 연결합니다. 에이전트 통합은 AI 어시스턴트가 여러분이 만든 게시된 앱을 사용하게 합니다. 어시스턴트가 Lovable 프로젝트 자체를 편집하게 하지는 않습니다. 그것은 별도 기능인 Lovable MCP 서버입니다.

에이전트 통합을 추가해야 할까

사용하는 이유

• 사용자가 이미 일하는 곳에 도달합니다. 사용자는 앱을 직접 열지 않고 AI 어시스턴트 안에서 앱을 다룰 수 있습니다.
• 앱을 다시 만들지 않고 새로운 경험을 제공합니다. 통합은 기존에 게시된 앱에서 생성되므로 어시스턴트가 같은 기능을 사용하는 또 하나의 방법이 됩니다.
• 접근과 수익화를 제어합니다. 게시 전에 제안된 모든 도구를 검토하고 통합에 로그인을 요구할지 로그인 없이 제공할지 결정합니다. 앱이 역할·플랜·기타 접근 규칙을 계속 강제하므로 어시스턴트 접근을 유료 플랜의 혜택으로 만들 수 있습니다.
• Lovable이 서버를 호스팅하고 유지합니다. Lovable이 MCP 서버를 운영하고 표준이 발전해도 호환성을 유지합니다. 게시한 도구·접근 규칙·앱 동작의 관리 권한은 계속 여러분에게 있습니다.

사용 사례와 예시

에이전트 통합은 앱에 데이터, 워크플로, 지식 또는 반복 가능한 전문성이 담겨 있을 때 가장 잘 작동합니다.

각 도구는 앱의 액션 하나입니다. 클라이언트 포털을 예로 들면 Lovable은 읽기 전용 list_open_requests 도구, create_request 도구, get_request_status 도구를 제안할 수 있습니다.

클라이언트가 어시스턴트에게 "나를 기다리는 요청이 있나요?"라고 물으면 어시스턴트는 list_open_requests가 질문에 맞는다고 인식해 호출하고 앱의 실시간 데이터로 답합니다.

하나의 앱이 여러 유형에 걸칠 수 있습니다. 어시스턴트를 통해 잘 작동하는 명확하고 유용한 작업 하나만 있으면 충분합니다.

적합하지 않을 수 있는 경우

에이전트 통합을 만들 수 있는 앱이라고 해서 모두 필요한 것은 아닙니다. Lovable은 도구를 제안할 뿐 통합이 앱에 가치 있거나 적절한지는 판단하지 않으므로 먼저 직접 고려하세요. 다음과 같은 경우 에이전트 통합의 가치가 제한적일 수 있습니다.

• 앱의 가치가 게임이나 포트폴리오 사이트처럼 주로 시각적·상호작용적인 경우. 게임도 통계 조회나 토너먼트 관리 같은 유용한 도구를 가질 수 있지만 턴 단위 게임 플레이는 보통 앱 자체 인터페이스가 더 적합합니다.
• 어시스턴트가 사용할 의미 있는 액션이나 정보가 없는 정적 사이트인 경우
• 가능한 도구가 느리거나 비용이 크거나 파괴적이거나 되돌리기 어렵거나 두 번 실행하면 안전하지 않은 것뿐인 경우
• 도구가 사용 사례에 필요한 것보다 많은 데이터나 기능을 노출하게 되는 경우

사전 요구 사항

에이전트 통합을 추가하기 전에 앱이 다음 요건을 충족하는지 확인하세요.

• 공개 게시된 앱. 통합은 게시된 버전의 앱을 제공하며 MCP 링크는 앱이 공개 게시된 후에만 사용할 수 있습니다.

  Business와 Enterprise 워크스페이스에서는 통합을 활성화하기 전에 앱이 공개 게시되어 있어야 합니다. 다른 플랜에서는 게시 전에 도구를 생성하고 검토할 수 있지만 앱이 공개 게시되기 전까지 통합은 사용자에게 제공되지 않습니다.

• 백엔드. 통합을 실행하고 사용자를 로그인시키려면 백엔드가 필요합니다. Lovable Cloud 또는 직접 연결한 Supabase 프로젝트 중 하나면 됩니다. 데이터베이스나 로그인이 없는 프런트엔드 전용 사이트처럼 백엔드가 없는 앱은 에이전트 통합을 호스팅할 수 없습니다.

• 직접 연결한 Supabase 프로젝트의 OAuth 2.1. 자체 Supabase 프로젝트를 연결했다면 Supabase 대시보드에서 OAuth 2.1 인증 서버를 활성화한 뒤 Lovable에서 프로젝트를 다시 연결하세요. 이것이 없으면 통합이 로그인을 요구할 수 없어 Lovable이 빌드하지 않습니다. Lovable Cloud 앱은 이미 설정되어 있습니다.

• 지원되는 스택. 에이전트 통합은 TanStack Start 기반의 새 앱과 React + Vite 기반의 이전 앱을 지원하며 후자는 통합을 Supabase Edge Function으로 호스팅합니다. 앱이 어느 쪽인지 알 필요는 없습니다. 차이는 Lovable이 처리합니다.

비용, 크레딧, 사용량 한도

도구 호출 비용은 그 뒤에 있는 액션의 비용과 같습니다. 각 호출은 앱의 일반 백엔드 로직을 실행하므로 데이터베이스 작업, Lovable Cloud 사용량, AI 기능, 서드파티 서비스는 앱을 직접 사용할 때와 같은 방식으로 사용량에 집계되거나 요금이 발생합니다.

Lovable은 통합 호스팅, 게시, 도구 호출에 별도 요금을 부과하지 않습니다.

기본 제공 속도 제한이나 지출 상한이 없으므로 유료이거나 리소스를 많이 쓰는 액션은 앱이 이미 제한하는 경우에만 노출하세요. 자세한 내용은 에이전트 통합에 속도 제한을 걸 수 있나요?를 참고하세요.

에이전트 통합을 활성화하거나 변경하면 Lovable의 일반 빌드 크레딧이 사용됩니다. Enable agent integrations를 선택하면 Lovable이 MCP 서버와 도구를 생성하거나 업데이트합니다. 크레딧 수는 앱과 필요한 작업량에 따라 달라집니다.

에이전트 통합 설정

집중된 소수의 도구로 시작하세요. 데이터를 수정하거나 유료 서비스를 호출하거나 상당한 리소스를 소비하는 액션을 노출하기 전에 읽기 전용 도구를 먼저 두는 편이 좋습니다.

게시 전에 각 도구가 무엇을 할 수 있는지, 어떤 입력을 받는지, 어떤 데이터를 반환하는지, 액션이 앱의 권한·플랜 검사를 강제하는지, 어시스턴트가 호출을 재시도해도 안전한지 확인하세요.

통합 추가

Add a read-only tool that looks up an order by ID and returns its current status and items.

Lovable 채팅에서 설정을 시작할 수도 있습니다.

Add Agent integrations to this app so users can connect it to AI assistants like ChatGPT and Claude.

도구 검토

AI tools 섹션은 통합을 통해 사용 가능한 도구와 각 도구가 할 수 있는 일을 보여줍니다.

각 도구에는 상태가 표시됩니다.

• Active: 도구가 게시된 통합에 라이브 상태이며 어시스턴트가 호출할 수 있습니다.
• Not published: 마지막 게시 이후 도구를 추가하거나 변경해 어시스턴트에 아직 업데이트가 보이지 않습니다. 앱을 게시해 라이브로 만드세요. 그동안 마지막 게시의 도구는 계속 작동합니다.
• Inactive: 통합을 현재 사용할 수 없습니다. 예를 들어 앱이 더 이상 공개 게시 상태가 아닌 경우입니다. 어시스턴트가 도구를 호출할 수 없습니다.

각 도구에는 기능 레이블도 있습니다.

• Read-only: 정보를 읽기만 하는 도구입니다.
• May modify data: 데이터를 생성·변경·삭제할 수 있는 도구입니다. 가장 신중하게 검토하세요.

도구는 앱을 게시할 때 라이브가 됩니다. 별도의 도구 승인 단계가 없으므로 MCP 링크를 공유하기 전에 모든 활성 도구를 검토하세요.

각 도구에서 확인할 사항은 다음과 같습니다.

• 수행하는 액션. 도구가 이름과 설명이 말하는 것만 하는지 확인합니다.
• 받는 입력. 광범위한 쿼리나 임의의 필드 값보다는 특정 레코드 식별자처럼 작업에 맞는 좁은 입력이 좋습니다.
• 반환하는 데이터. 작업에 필요한 필드만 반환하세요. 읽기 전용 도구도 민감하거나 불필요한 정보를 노출할 수 있습니다.
• 접근 검사. 액션이 앱이 기대하는 소유권·역할·권한·유료 플랜 요건을 강제하는지 확인합니다.
• 재시도 동작. 데이터를 변경하는 도구는 호출을 반복해도 중복되거나 의도치 않은 변경이 생기지 않는지 확인합니다.

어시스턴트는 사용자의 요청과 도구 설명을 바탕으로 어떤 도구를 호출할지 선택하므로 도구 이름과 설명이 중요합니다. 비교해보세요.

• 모호함: get_data, 설명은 "Gets data."
• 명확함: list_open_orders, 설명은 "Returns the signed-in customer's open orders with order number, status, and total."

일상 언어로 Lovable에게 도구 조정을 요청할 수 있습니다.

Remove any tool that can delete records.

Rename the customer lookup tool so it is clear that it searches by email address.

접근, 로그인, 권한

에이전트 통합은 기본적으로 로그인을 요구합니다. Lovable이 MCP 서버를 생성할 때 인증된 설정을 제안하며 도구를 공개로 만들려면 항상 명시적인 선택이 필요합니다.

로그인, 권한, 도구 노출은 서로 다른 세 개의 계층이며 구분해서 이해하는 것이 좋습니다.

• 로그인은 호출자를 식별합니다. AI 어시스턴트를 통해 연결하는 사람은 앱을 통해 인증합니다. 앱의 로그인 화면을 본 다음 어시스턴트의 접근을 승인하는 동의 화면을 봅니다. 둘 다 연결 과정의 정상적인 부분입니다.
• 앱의 규칙이 호출자가 할 수 있는 일을 결정합니다. 도구는 로그인한 사용자로서 동작합니다. 각 고객이 자신의 레코드만 보는 것처럼 앱이 백엔드에서 강제하는 규칙은 도구 호출에도 적용되며 생성된 도구가 이를 우회할 수 없습니다. 레코드 소유, 역할 보유, 유료 플랜 가입 같은 추가 요건은 액션 자체가 검사할 때만 적용됩니다.
• 도구 정의가 무엇이 노출되는지 결정합니다. 각 도구의 입력, 수행하는 액션, 반환하는 데이터를 검토하세요.

도구 호출은 앱 화면을 거치지 않습니다. 숨긴 버튼, 메뉴에서 제거한 페이지 같은 인터페이스 수준의 통제만으로는 백엔드 액션을 보호할 수 없습니다.

접근 구성 선택

두 가지 접근 구성 중 하나를 선택합니다.

• 로그인 필수(기본값). 모든 도구가 사용자 인증을 요구합니다. 개별 액션은 앱 백엔드에서 역할·소유권·유료 플랜 요건을 추가로 강제할 수 있으므로 유료 사용자에게만 기능을 제한하는 앱은 어시스턴트 호출에도 그 제한을 유지합니다. Lovable은 게시할 때 앱 백엔드에서 OAuth 기능을 활성화하며 사용자가 앱 자체에 로그인하는 방식은 바꾸지 않습니다.
• 로그인 없음. 모든 도구를 사용자 인증 없이 호출할 수 있습니다. 이것은 의도적 선택입니다. Lovable이 확인을 요청하고 로그인 없이 도구가 무엇을 노출하는지 요약합니다.

현재 접근 설정 확인

Agent integrations 패널은 현재 설정을 상태 카드로 보여줍니다.

• 도구가 로그인을 요구하면 Access is protected 카드와 Sign-in enabled 배지가 표시됩니다.
• 도구가 로그인을 요구하지 않으면 Anyone can connect to your app 카드와 Public access 배지가 표시됩니다. 이 카드에는 Add sign-in 버튼이 있으며 선택하면 통합에 인증을 추가하는 빌드가 시작됩니다.

통합을 오래전에 설정했다면 패널을 열어 상태 카드가 기대하는 접근을 보여주는지 확인하세요. 공개와 보호 간 전환은 설정 토글이 아니라 빌드입니다. 공개 카드의 Add sign-in을 지름길로 선택하거나 채팅으로 Lovable에게 요청하면 앱의 인증 설정을 업데이트합니다.

예를 들어 Lovable에게 이렇게 요청할 수 있습니다.

Require users to sign in before they can use this agent integration, and make sure the export report action checks whether the user is on a paid plan.

자동 보안 검사

Lovable은 통합에 두 가지 자동 보안 검사를 실행합니다.

• 기본 검사, 매 게시 시점. 통합이 로그인 없는 접근을 허용하는지 확인하고 게시 흐름에서 경고합니다. 엄격한 보안 설정이 있는 워크스페이스에서는 비공개 앱이 인증 없는 도구를 노출하면 게시가 차단됩니다.
• 심층 스캔, 공개 통합을 게시할 때. 도구가 로그인을 요구하지 않는다면 새 통합이나 변경된 통합을 게시할 때 도구 자체에 대한 더 깊은 스캔도 시작됩니다. 각 도구가 실제로 무엇을 노출하는지 확인하고 개인 데이터 노출, 의도치 않은 레코드 변경, 대량 데이터 접근, 페이월 우회 같은 일반적인 위험 패턴을 표시합니다.

두 검사의 발견 사항은 프로젝트의 More → Security에 나타나며 심층 스캔 발견 사항은 App MCP data exposure 아래에 표시됩니다.

심각한 심층 스캔 발견 사항은 critical로 표시됩니다. 워크스페이스가 critical 보안 발견 시 게시를 차단한다면 해결하기 전까지 다시 게시할 수 없습니다. 발견 사항을 열어 문제를 검토한 뒤 Lovable에게 수정을 요청하거나 해당되지 않으면 무시로 표시하세요.

자동 검사가 직접 검토를 대체하지는 않으며 앱의 커스텀 비즈니스 로직에 따라 달라지는 위험은 감지하지 못할 수 있습니다. 통합을 공유하기 전에 도구 검토와 공유 전 테스트의 점검 항목을 확인하세요.

Lovable 보안 스캔의 전반적인 동작은 보안 개요와 프로젝트 보안 뷰를 참고하세요.

공유 전 테스트

사용자가 쓸 법한 어시스턴트(ChatGPT, Claude 등)에서 직접 앱을 연결하고 MCP 링크를 공유하기 전에 주요 워크플로를 테스트하세요.

통합이 로그인을 요구한다면 앱의 로그인 화면과 동의 화면을 포함한 전체 연결 흐름을 테스트하세요. 연결·인증 문제는 대개 거기서 먼저 나타납니다.

최소한 다음을 테스트하세요.

• 일반 로그인 사용자로 각 도구를 실행
• 필요한 역할·소유권·유료 플랜이 없는 사용자로 보호된 도구를 시도하고 접근이 거부되는지 확인
• 존재하지 않거나 다른 사용자 소유인 레코드를 요청
• 각 도구가 작업에 필요한 필드만 반환하는지 확인
• 쓰기 액션을 두 번 실행해 중복되거나 의도치 않은 변경이 생기지 않는지 확인
• 유료이거나 리소스를 많이 쓰는 액션을 앱의 사용량·플랜 한도에 대해 테스트
• 로그인 없는 통합이라면 앱에 로그인하지 않은 세션에서 연결해 정확히 어떤 액션과 데이터가 제공되는지 확인

사용자 연결

통합이 라이브가 되면 사용자는 MCP 링크로 앱을 자신의 AI 어시스턴트에 연결합니다.

지원되는 어시스턴트

원격 MCP 서버에 연결하고 로그인 흐름을 완료할 수 있는 모든 AI 어시스턴트·에이전트에서 앱이 작동합니다. Lovable은 다음에 대해 제품 내 연결 안내를 제공합니다.

• ChatGPT
• Claude

Claude Code, Cursor, VS Code 같은 다른 MCP 클라이언트는 각자의 커스텀 커넥터 설정을 통해 같은 MCP 링크로 연결합니다.

설정 흐름은 어시스턴트마다 다르고 시간이 지나며 바뀔 수 있습니다. More → Agent integrations를 열고 How to connect를 펼치면 최신 ChatGPT·Claude 연결 단계를 볼 수 있습니다. 다른 어시스턴트는 해당 어시스턴트의 공식 문서를 안내하세요.

MCP 링크 공유

게시 후 Lovable은 More → Agent integrations의 Your MCP link 카드에 앱의 MCP 링크를 표시합니다. 사용자는 이 링크를 어시스턴트에 커스텀 커넥터로 추가합니다.

링크를 직접 공유할 수도 있고 통합이 무엇을 하는지 설명하고 MCP 링크를 담아 사용자가 자신이 쓰는 어시스턴트에서 연결하도록 돕는 연결 페이지를 앱 안에 만들 수도 있습니다.

연결 페이지를 만들려면 How to connect를 펼치고 Ask Lovable to build를 선택하세요.

어시스턴트 설정 흐름은 바뀔 수 있으므로 유지 관리하지 않을 페이지에 상세한 연결 단계를 복사하는 것은 피하세요. 각 어시스턴트의 공식 문서로 링크하거나 설정 흐름이 바뀔 때마다 페이지를 검토하세요.

통합 유지 관리

출시 후 도구, 접근 로직, 백엔드 동작, 앱 도메인을 변경할 때마다 통합을 다시 점검하세요. 변경 사항은 게시를 통해 사용자에게 전달되며 통합이 노출하는 것에 대한 책임은 계속 여러분에게 있습니다.

최신 상태 유지

통합은 게시된 버전의 앱을 제공합니다. 앱, 도구, 접근 로직, 도메인을 변경한 후에는 다음을 수행하세요.

More → Agent integrations를 열고 Refresh after app changes를 펼치면 ChatGPT와 Claude의 새로고침 단계를 볼 수 있습니다. 다른 어시스턴트는 해당 어시스턴트의 공식 문서를 안내하세요.

Lovable은 표준이 발전함에 따라 호스팅된 MCP 설정을 유지하며 프로토콜 변경은 버전 업데이트로 제공됩니다. 업데이트가 앱 변경을 필요로 하면 Lovable이 업그레이드 경로를 제공합니다.

MCP 링크가 바뀌는 경우

MCP 링크는 원할 때 바꿀 수 없습니다.

• TanStack Start 앱의 링크는 앱의 웹 주소를 기반으로 하므로 앱의 기본 커스텀 도메인을 변경하면 링크도 바뀌고 사용자가 새 링크를 어시스턴트에 다시 붙여넣어야 합니다.
• 이전 React + Vite 앱의 링크는 앱의 백엔드 함수를 가리키므로 도메인이 바뀌어도 변하지 않습니다.

모니터링, 비활성화, 제거

도구 오류는 다른 백엔드 오류처럼 앱 로그에 나타납니다. 도구 호출을 신원과 연결해야 한다면 로그인을 켜두세요. 그러면 모든 호출이 앱의 로그인한 사용자로부터 옵니다.

통합을 중지하거나 제한하는 방법은 다음과 같습니다.

• 도구 제거. Lovable에게 제거를 요청한 뒤 게시하면 도구가 통합에서 사라집니다.
• 통합 전체 제거. Lovable에게 앱에서 에이전트 통합 제거를 요청한 뒤 게시합니다. Lovable이 생성된 코드를 제거하고 MCP 서버를 오프라인으로 전환합니다. 앱은 이전처럼 계속 작동합니다.
• 앱 게시 취소. 앱과 함께 MCP 서버가 즉시 오프라인이 됩니다. 앱이 게시 취소된 동안 기존 어시스턴트 연결은 서버를 호출할 수 없습니다.
• 프로젝트 삭제. 앱과 MCP 서버가 영구 제거됩니다.

모범 사례

• 핵심 사용자 작업부터 시작하세요. 사용자가 이미 앱에 와서 완료하는 액션을 도구로 만드세요. 새 앱 기능이 자동으로 도구가 되지는 않으므로 어시스턴트가 사용하길 원하는 액션마다 Lovable에게 노출을 요청하세요.
• 명확한 도구 이름과 설명을 쓰세요. 도구가 무엇을 하는지, 어떤 입력이 필요한지, 어떤 결과를 반환하는지 설명하세요. 명확한 이름과 설명은 어시스턴트가 올바른 도구를 선택하도록 돕습니다.
• 작업에 필요한 데이터만 반환하세요. 도구는 액션뿐 아니라 반환 데이터도 노출합니다. Lovable에게 결과를 도구 목적에 필요한 필드로 제한하도록 요청하세요.
• 읽기와 쓰기 액션을 분리하세요. 정보만 조회하는 도구와 데이터를 생성·수정·삭제할 수 있는 도구를 명확히 구분하세요.
• 쓰기 액션을 재시도에 안전하게 만드세요. 어시스턴트는 타임아웃이나 연결 오류 후 호출을 재시도할 수 있고 무언가를 생성·변경하는 도구는 같은 주문을 두 번 만드는 식으로 작업을 두 번 수행할 수 있습니다. 변경이 이미 적용됐는지 확인하거나 요청 식별자를 사용하는 방식으로 반복 호출이 변경을 중복시키지 않게 쓰기 도구를 설계하도록 Lovable에게 요청하세요.
• 로그인을 기본으로 켜두세요. 노출된 모든 액션과 반환 필드가 익명 사용에 안전할 때만 로그인 없는 접근을 허용하세요.
• 제한된 접근은 앱에서 강제하세요. 도구가 비공개 정보를 반환하거나 레코드를 변경하거나 유료 기능을 실행한다면 액션을 완료하기 전에 사용자의 권한·소유권·역할·플랜을 확인하세요.
• 도구 변경 후 게시하세요. 새로 만들거나 제거하거나 업데이트한 도구는 앱을 게시하기 전까지 사용자에게 전달되지 않습니다.
• 연결 페이지를 추가하세요. 사용자에게 MCP 링크를 제공하고 통합이 할 수 있는 일을 설명하고 최신 설정 안내로 연결하세요. MCP 링크 공유를 참고하세요.

제한 사항

• 오래 걸리는 도구는 타임아웃될 수 있습니다. 도구는 한 번에 하나의 액션을 실행하고 어시스턴트는 시간 제한을 두고 결과를 기다립니다. 큰 파일 처리나 미디어 생성처럼 수십 초 이상 걸리는 작업은 어시스턴트에서 멈추거나 중단된 것처럼 보일 수 있습니다. 도구는 빠르게 유지하고 무거운 작업은 앱 안에서 실행하세요.
• 통합은 스스로 알림을 보낼 수 없습니다. 앱이 어시스턴트에게 알림을 보낼 수 없습니다. 어시스턴트는 사용자가 요청할 때만 동작하므로 "이걸 지켜보다가 알려줘" 같은 워크플로는 작동하지 않습니다.
• 도구 변경 후 사용자가 새로고침해야 합니다. 어시스턴트는 도구 목록의 사본을 보관합니다. 도구를 추가·제거하거나 이름을 바꾸고 게시한 뒤에도 사용자는 커넥터를 새로고침하기 전까지 이전 목록을 보게 되어 라이브 통합의 반복 개선이 느려집니다.
• 검색 디렉토리가 없습니다. 사용자가 에이전트 통합 디렉토리를 둘러볼 수 없습니다. MCP 링크는 직접 사용자에게 공유해야 합니다.

FAQ

문제 해결