AI 연결
Claude 또는 ChatGPT를 Realton에 연결하기
주소 하나로 Claude, ChatGPT, Claude Code, Cursor를 내 Realton에 연결합니다. 로그인한 후 어떤 앱이 어떤 워크스페이스에 접근을 요청하는지 확인하고 허용을 누르세요.
Pro 요금제 이상주소
아래의 모든 앱에서 이 주소를 씁니다. 키는 필요 없습니다.
https://realton.ai/mcpPro 이상 요금제의 Realton 워크스페이스와 AI 앱 계정이 필요합니다. 커넥터를 추가할 수 있는 요금제는 각 앱이 정합니다.
Claude
claude.ai, 데스크톱 앱, 모바일 앱에서 쓸 수 있습니다. 한 번 추가하면 모든 곳에서 나타납니다.
- Customize를 열고 Connectors를 선택하세요.
- + Add를 누른 후 Add custom connector를 선택하세요.
- 이름을 Realton으로 정하고 주소를 붙여 넣은 후 Continue를 누르세요.
- Claude가 찾은 로그인 설정을 그대로 두고 Continue를 누른 후 Add를 누르세요.
- Realton이 열립니다. 로그인을 요청하면 로그인하고, 워크스페이스를 확인한 후 허용을 누르세요.
- 채팅에서 +를 누르고 Connectors에서 Realton을 켜세요.
Claude Team 또는 Enterprise에서는 소유자가 한 번만 추가하면 됩니다: Organization settings › Connectors › Add › Custom › Web. 이후 각 사용자가 Customize › Connectors에서 Realton을 찾아 Connect를 누릅니다.
Claude Free 요금제에서는 맞춤 커넥터를 하나만 추가할 수 있습니다.
ChatGPT
브라우저에서 chatgpt.com을 사용합니다.
- chatgpt.com/plugins에서 Plugins를 여세요.
- +를 누른 후 Add custom MCP server를 선택하세요.
- 이름을 Realton으로 정하고 주소를 Server URL에 붙여 넣으세요.
- 인증 방식으로 OAuth를 선택하세요.
- 경고를 읽고 I understand and want to continue를 선택한 후 Create as a plugin을 누르세요.
- Realton이 열립니다. 로그인을 요청하면 로그인하고 허용을 누르세요.
- 채팅에서 @를 입력하고 Realton을 선택하세요.
맞춤 MCP 서버를 추가할 수 있는지는 ChatGPT 요금제에 따라 다르며, Business 또는 Enterprise 워크스페이스에서는 관리자의 허용 여부에 따라 다릅니다.
Claude Code
- 모든 프로젝트에 Realton 추가:
claude mcp add --transport http --scope user realton https://realton.ai/mcp - Claude Code에서
/mcp를 입력하고 realton을 선택한 후, 열리는 브라우저에서 로그인하세요. Realton 페이지에서 허용을 누르면 됩니다.
Cursor
- 모든 프로젝트에 쓰려면
~/.cursor/mcp.json에, 한 프로젝트에만 쓰려면 그 프로젝트의.cursor/mcp.json에 Realton을 추가하세요:mcp.json{ "mcpServers": { "realton": { "url": "https://realton.ai/mcp" } } } - 처음 연결할 때 Cursor가 Realton 로그인 화면으로 안내합니다. 허용을 누르세요.
키를 쓰는 앱
일부 앱은 로그인 대신 고정된 헤더를 보냅니다. 소유자나 관리자가 설정 › API 및 MCP에서 AI 클라이언트(MCP)를 선택해 키를 만들면, 앱은 Authorization: Bearer 뒤에 키를 붙여 보냅니다.
claude mcp add --transport http --scope user realton https://realton.ai/mcp \
--header "Authorization: Bearer rtk_live_…"{
"mcpServers": {
"realton": {
"url": "https://realton.ai/mcp",
"headers": {
"Authorization": "Bearer ${env:REALTON_MCP_KEY}"
}
}
}
}키는 키를 만든 사람의 권한으로 작동합니다. 채팅, 공유 파일, 스크린샷에 키가 노출되지 않게 하세요. 유출되었다면 설정에서 폐기하고 새로 만드세요.
스스로 연결을 요청하는 AI 에이전트
직접 운영하는 AI 에이전트는 커넥터 없이 Realton 연결을 요청할 수 있습니다. 에이전트가 내 이메일을 지정하고 링크와 6자리 코드를 보여 주면, Realton에 로그인해 요청한 워크스페이스를 확인하고 코드를 입력하세요. 그때부터 에이전트는 내 권한으로 작동하며(Pro 요금제부터), 연결된 앱과 함께 설정 › API 및 MCP에 표시됩니다. 에이전트용 절차는 /auth.md에 있습니다.
AI가 할 수 있는 일
Realton 자체 어시스턴트와 같은 작업을 같은 범위에서 합니다. 에이전트는 자신의 고객을, 소유자나 관리자는 에이전시 전체 고객을 다룹니다.
| 기능 | 요청 예시 |
|---|---|
| 지역, 침실 수, 예산, 인도 연도, 인도 후 납부 조건으로 고객에게 맞는 프로젝트를 찾습니다. search_projects | 두바이에서 AED 200만 이하, 2028년까지 인도되는 침실 2개 아파트를 찾아 주세요. |
| 프로젝트의 유닛 유형, 가격, 납부 플랜, 내 커미션을 보여 줍니다. project_details | Soma Residences 침실 2개 유닛은 인도 전에 얼마를 내야 하나요? |
| 이름이나 이메일로 고객을 찾습니다. find_clients | 내 고객 중 이름이 Elena인 사람은 누구인가요? |
| 고객의 희망 조건, 거래, 후보 목록, 열어 본 브로슈어, 최근 메시지를 보여 줍니다. client_context | Elena Petrova 님과는 지금 어디까지 진행됐나요? |
| 내 브랜드의 브로슈어 링크를 초안으로 만들어, 직접 보낼 수 있게 합니다. make_brochure | Elena 님에게 보낼 Soma Residences 브로슈어를 영어로 만들어 주세요. |
| 말한 시간에 맞춰 내 시간대 기준으로 할 일이나 알림을 추가합니다. add_task | 내일 11시에 Elena 님에게 전화하라고 알려 주세요. |
| 고객 카드에 메모를 남깁니다. add_note | Elena 님 메모: 바다 전망 희망, 예산 AED 200만. |
| 고객의 거래를 다른 단계로 옮깁니다. move_deal | Elena 님 거래를 현장 방문 단계로 옮겨 주세요. |
| CRM에 고객을 추가합니다. add_client | Omar Haddad, +971 50 555 0147, 아랍어 사용 고객을 추가해 주세요. |
| 고객의 후보 목록에 프로젝트를 추가합니다. shortlist_project | Elena 님 후보 목록에 Soma Residences를 추가해 주세요. |
| 내 브랜드로 프로젝트 게시물 초안(캐러셀 또는 배너)을 만듭니다. draft_post | Soma Residences 캐러셀을 만들어 주세요. |
안전하게 지키는 방법
- 연결을 허용한 사람의 권한으로 작동하며, 그 사람이 Realton에서 볼 수 있는 것만 봅니다.
- 고객에게는 아무것도 보내지 않습니다. 브로슈어 링크나 게시물은 초안으로 만들어지며, 직접 열어 확인한 후 보냅니다.
- 연결한 모든 앱은 설정 › API 및 MCP에 표시되며, 여기에서 연결을 해제할 수 있습니다. 소유자나 관리자는 팀 전체의 앱을 볼 수 있습니다.
- 워크스페이스가 Pro 요금제를 벗어나거나, 연결을 허용한 사람이 워크스페이스를 떠나면 자동으로 중지됩니다.
작동하지 않을 때
앱에 “AI 클라이언트 연결은 Pro 요금제 이상에서 사용할 수 있습니다”라고 표시됩니다
워크스페이스가 Free 요금제입니다. 요금제를 변경한 후 다시 연결하세요.
Realton에 “연결 링크가 완전하지 않습니다”라고 표시됩니다
앱이 연 링크가 잘렸거나 너무 오래되었습니다. AI 앱에서 다시 시작하세요.
앱에 연결이 끊겼다고 표시됩니다
설정에서 연결이 해제되었거나, 연결을 허용한 사람이 워크스페이스를 떠났습니다. 앱에서 Realton을 삭제한 후 다시 추가하세요.
Claude에서 커넥터를 더 추가할 수 없습니다
Claude Free 요금제에서는 맞춤 커넥터를 하나만 쓸 수 있습니다. 다른 커넥터를 삭제하거나 Claude 유료 요금제로 바꾸세요.
ChatGPT에 Add custom MCP server가 보이지 않습니다
ChatGPT 요금제 또는 워크스페이스 관리자가 맞춤 MCP 서버를 허용하지 않는 경우입니다.