커스텀 커넥터 만들기

공개 API든 사내 API든 모든 REST API용 커넥터를 직접 만들어 Lovable 워크스페이스에서 사용하세요. endpoint, 인증, 지식을 한 번 정의해 두면 워크스페이스의 모든 사람이 다른 앱 커넥터와 똑같이 연결할 수 있습니다.

공개 서드파티 API든 사내 서비스든, 모든 REST API용 커넥터를 직접 만들어 Lovable 워크스페이스에서 사용할 수 있습니다. 커넥터를 한 번 정의해 두면(API endpoint, 인증 방식, 선택 사항인 지식 파일) 워크스페이스의 모든 사람이 다른 앱 + 채팅 커넥터와 똑같이 연결할 수 있습니다.

직접 만든 커넥터는 앱 + 채팅 커넥터입니다. 빌드한 앱이 이 커넥터로 API를 호출하고, 추가한 지식 파일의 안내에 따라 Lovable도 빌드 중 이 커넥터를 함께 사용합니다. 도구의 컨텍스트를 Lovable 채팅으로 가져오기만 하려면 대신 커스텀 MCP 서버를 채팅 커넥터로 연결하세요.

커넥터를 만들 수 있는 사람

커넥터를 만들고 관리하려면 워크스페이스 admin 또는 owner 역할이 필요하며, 모든 플랜에서 사용할 수 있습니다. 직접 만든 커넥터는 단일 워크스페이스로 범위가 한정됩니다. 해당 워크스페이스의 커넥터 카탈로그에만 나타나고 다른 워크스페이스에는 보이지 않습니다.

커넥터를 만들고 나면 워크스페이스 멤버는 다른 앱 + 채팅 커넥터와 같은 방식으로 연결합니다.

커넥터 만드는 방법

커넥터 전체를 Details, Authentication, Agent Knowledge 세 섹션으로 이루어진 하나의 양식에서 정의하며, 커넥터 카탈로그의 + 버튼으로 엽니다.

인증 방식

API가 자격 증명을 요구하는 방식에 맞는 방법을 고르세요.

OAuth 2.0 설정하기

OAuth 2.0을 사용하는 API라면 다음을 설정합니다.

• Authorization URL과 Token URL: 제공자의 OAuth endpoint입니다(둘 다 https://여야 합니다).
• Scopes(선택): 한 줄에 하나씩 쓰거나 공백 또는 쉼표로 구분합니다.
• Scope separator(선택): 기본값(공백)을 쓰려면 비워 둡니다. 일부 제공자는 쉼표를 요구합니다.
• Use PKCE: 제공자가 PKCE를 지원하거나 요구하면 활성화합니다.

양식에 Redirect URI to register with your provider가 표시됩니다. 이를 복사해 OAuth 앱의 허용된 redirect(callback) URL에 추가하세요. 정확히 일치해야 합니다.

커넥터 지식 파일 작성하기

커넥터 지식 파일은 Lovable이 API 사용법을 배우는 수단입니다. 지식 파일이 없으면 Lovable은 base URL과 인증 방식만 알기 때문에 endpoint 경로, 파라미터 이름, 응답 형태를 추측해야 합니다. 잘 쓴 지식 파일은 이 추측을 없애 줍니다. 사람이 아니라 Lovable을 위해 쓰는 문서라고 생각하세요.

지식 파일은 워크스페이스 및 프로젝트 지식과 별개입니다. 커넥터 지식은 커넥터를 따라다니며 그 API를 호출하는 방법만 다룹니다.

각 지식 파일은 세 부분으로 이루어집니다.

• Name: 짧은 식별자입니다(예: Acme Projects API basics).
• Description: 파일이 다루는 내용을 한 줄로 요약해, Lovable이 작업에 맞는 파일을 고르게 합니다(예: Endpoints and request formats for reading and writing Acme Projects boards and tasks.).
• Content: 실제 지침을 Markdown으로 작성합니다. endpoint, 예시, 주의 사항이 들어가는 곳입니다.

포함할 내용

Lovable이 기본 제공 커넥터에 쓰는 구조를 그대로 따르세요.

1. 한 줄 요약으로 API가 무엇을 하고 어디에 쓰는지 밝힙니다.
2. 주요 endpoint: method, 경로, 각각의 역할을 적습니다. API base URL 기준의 상대 경로를 쓰세요(예: GET /v1/tasks). Lovable이 요청을 라우팅하고 자격 증명을 자동으로 붙이므로 전체 URL이나 인증 header를 직접 넣지 마세요.
3. 요청 예시를 가장 자주 쓰는 작업에 대해 코드블록으로 보여 줍니다. 정확한 body 형태, 필수 파라미터, query 옵션을 담으세요.
4. 응답 형태: Lovable이 예상해야 할 wrapper와 필드 이름을 언급합니다(예: "응답은 최상위 data 필드로 감싸집니다").
5. 참고 사항 절에는 통합에서 자주 발목을 잡는 것들을 적습니다. pagination 파라미터, rate limit, 경로의 API 버전, 비동기 작업, 날짜나 ID 형식 등입니다.

넣지 말아야 할 내용

지식 파일에 어울리지 않는 것도 있습니다.

• 자격 증명이나 secret: 토큰, 키, client secret을 지식 콘텐츠에 절대 넣지 마세요. 인증은 별도로 설정되어 자동으로 주입됩니다.
• 인증 상용구: Lovable에게 자격 증명을 붙이는 방법을 알려 줄 필요가 없습니다. 커넥터가 알아서 처리합니다.
• 마케팅 문구: 제품이 얼마나 훌륭한지에 대한 설명은 컨텍스트만 낭비합니다. 기술적 사실만 쓰세요.

예시

가상의 프로젝트 관리 API인 Acme Projects API용 지식 파일입니다.

This connector calls the Acme Projects API to manage projects and tasks.

## Key endpoints

- `GET /v1/projects`: list projects
- `GET /v1/projects/{id}/tasks`: list tasks in a project
- `POST /v1/tasks`: create a task
- `PATCH /v1/tasks/{id}`: update a task (status, assignee, due date)

## Creating a task

```json
POST /v1/tasks
{
  "project_id": "proj_123",
  "title": "Draft launch plan",
  "due_on": "2026-08-01",
  "assignee_id": "user_456"
}
```

## Notes

- All responses are wrapped in a top-level `data` field.
- List endpoints are paginated: pass `limit` (max 100) and the `next_cursor`
  value from the previous response.
- Dates use `YYYY-MM-DD` format; timestamps are ISO 8601 in UTC.
- Rate limit is 60 requests per minute; batch operations should back off
  on `429` responses.

커넥터 사용하기

만들고 나면 커넥터는 다른 앱 + 채팅 커넥터와 똑같이 동작합니다.

1. 사용자가 Connectors를 열고 카탈로그에서 커넥터를 찾아 Connect를 클릭합니다.
2. 정의해 둔 자격 증명 값(API 키, 사용자 이름과 비밀번호, 또는 OAuth Client ID와 secret)을 입력합니다. OAuth 커넥터는 팝업에서 제공자의 인가 절차가 진행됩니다.
3. Who can use this connection에서 누가 사용할 수 있는지 고릅니다. 본인만(기본값), 특정 사용자, 또는 워크스페이스 전체입니다. connection과 client를 사용할 수 있는 사람을 참고하세요.
4. Lovable이 설정해 둔 Verification path로 자격 증명을 확인합니다.
5. 연결되면 그 connection을 프로젝트에 링크할 수 있고, Lovable이 추가한 지식 파일의 안내를 받아 API를 호출하는 앱을 빌드할 수 있습니다.

커넥터 관리

워크스페이스 admin과 owner는 Connectors → Admin settings → App + chat connectors의 Custom connectors에서 워크스페이스에 만든 커넥터를 관리합니다. admin 설정 영역은 Business 및 Enterprise 플랜에서 사용할 수 있습니다.

• Availability: 다른 커넥터와 마찬가지로 누가 connection을 만들 수 있는지(No one, Admins, Editors & admins) 제어합니다. 새로 만든 커넥터는 Admins에서 시작합니다. Free와 Pro 플랜에는 선택기가 없어 editor 이상 역할을 가진 워크스페이스 멤버라면 누구나 connection을 만들 수 있습니다. 플랜별 기본값은 워크스페이스의 커넥터 관리를 참고하세요.
• Edit: 커넥터의 세부 정보, endpoint, 지식, 인증 설정을 갱신합니다. 기존 connection이 현재 형태로 자격 증명을 저장하고 있어 일부 인증 변경은 제한됩니다. 커넥터는 OAuth 2.0과 자격 증명 기반 인증 사이를 오갈 수 없고, 기존 자격 증명 필드 키는 잠깁니다. 단일 자격 증명 방식(bearer token, custom header, query parameter) 사이를 전환하거나, 자격 증명 기반 방식을 Advanced로 옮기는 것은 가능합니다.
• Delete: 워크스페이스에서 커넥터 정의를 제거합니다.

보안

커스텀 커넥터는 통합 보안에 설명된 대로 기본 제공 커넥터와 동일한 보안 모델을 따릅니다.

• 자격 증명 값은 connection을 만들 때만 입력하며 Lovable이 암호화해 저장합니다. connector gateway가 서버 측에서 요청에 주입하므로 채팅이나 프로젝트 코드, 다른 사용자에게 노출되지 않습니다.
• 워크스페이스에 공유한 connection은 다른 워크스페이스 멤버도 사용할 수 있습니다. 팀에 공개해도 괜찮은 데이터의 connection만 공유하세요.

FAQ

관련 주제

• 커스텀 MCP 서버를 채팅 커넥터로 연결
• Lovable 커넥터: 도구, 서비스, API 연결
• 구독 플랜
• Lovable에 모든 API 통합
• 앱 + 채팅 커넥터: 게시된 앱과 채팅에 기능 추가