> For the complete documentation index, see [llms.txt](https://www.analytics-docs.laplacetec.com/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.analytics-docs.laplacetec.com/guide/mcp/start.md).
# MCP 시작하기
{% hint style="info" %}
라플라스 MCP 연동이란?\
새로운 AI 도구를 도입하는 것이 아니라, 이미 사용하고 계신 AI(Claude, ChatGPT 등)에 라플라스의 정제된 데이터를 연결하는 기능이에요.\
연결하면 쓰시던 채팅창에서 이렇게 물어볼 수 있습니다. "지난주 매출 얼마야?", "광고 효율 안 좋은 상품 찾아줘", "이번 달 베스트셀러 10개 뽑아줘".
{% endhint %}
## 이용 조건
| 플랜 | MCP 이용 |
| ------------------------- | -------------------- |
| 무료 체험 | ✅ 체험 기간 동안 호출 100회까지 |
| Starter | ❌ 이용할 수 없어요 |
| Growth · Pro · Enterprise | ✅ |
* 플랜은 **프로젝트 소유자** 기준으로 확인해요. 초대받은 멤버라면 소유자의 플랜을 따릅니다.
* 무료 체험 중이라면 아래 **라플라스 계정 로그인** 방식으로 바로 연결해 보세요.
* 이용 조건이 맞지 않으면 AI가 답변 대신 안내 문구를 보여줘요. 문구별 해결 방법은 [문제 해결](/guide/mcp/troubleshooting.md)에 정리했어요.
## 어떤 방식으로 연결하나요?
연결 방법은 두 가지예요. 사용하시는 AI에 맞춰 골라 주세요.
| 방식 | 이런 분께 | 준비물 |
| --------------------------- | ------------------------------------------- | ---------------------- |
| **라플라스 계정 로그인 (OAuth, 권장)** | Claude, ChatGPT, Perplexity를 웹·앱에서 쓰시는 분 | 라플라스 계정만 있으면 돼요 |
| **API 키** | Claude Code, Cursor, VS Code 등 개발 도구를 쓰시는 분 | 라플라스에서 API 키를 발급받아야 해요 |
대부분의 경우 **라플라스 계정 로그인**이면 충분해요. API 키는 발급하지 않으셔도 됩니다.
## 어떤 AI에서 쓸 수 있나요?
| AI 도구 | 사용 가능 | 연결 방식 | 안내 |
| ----------------- | ----- | ------ | --------------------------------------------------------- |
| Claude (웹·앱) | ✅ 추천 | 계정 로그인 | 설치가 가장 쉬워 처음이라면 Claude를 추천드려요 |
| ChatGPT | ✅ 추천 | 계정 로그인 | 설정에서 개발자 모드를 켠 뒤 등록해요 |
| Perplexity | ✅ 유료 | 계정 로그인 | Pro 이상 유료 플랜에서 연결할 수 있어요 |
| Claude Code (CLI) | ✅ | API 키 | 개발 도구. 명령어 한 줄로 등록해요 |
| Cursor / VS Code | ✅ | API 키 | 개발 도구. 개발자분이 계시면 사용 가능해요 |
| Gemini (제미나이) | ⚠️ 일부 | API 키 | 개발자용 **`Gemini CLI`**에서만 가능하고, 일반 앱·웹은 아직 지원되지 않아요 |
## 연동 가능 MCP
라플라스 계정 로그인으로 연결하실 AI를 선택한 뒤 가이드에 따라 진행해 주세요.
## API 키 발급
Claude Code, Cursor, VS Code 같은 개발 도구에서 쓰실 때만 필요해요.
1. **`설정`** → **`API 연동`** → **`API 키`** 메뉴로 이동합니다
2. **`이름`**과 **`설명`**을 작성하고 **`만료`** 기간(30일, 90일, 1년, 만료 없음)을 골라 발급받습니다
3. 발급된 API 키를 안전한 곳에 저장합니다
{% hint style="warning" %}
API 키는 발급 직후에만 확인할 수 있어요. 잃어버리셨다면 기존 키를 삭제하고 새로 발급해 주세요.\
API 키는 발급한 프로젝트 하나에만 연결됩니다.
{% endhint %}
## MCP 등록
API 키를 발급하면 발급 완료 창에 **Claude Code, Cursor, VS Code, Claude Desktop**용 등록 명령어가 함께 표시돼요. 사용하시는 도구를 골라 명령어를 복사한 뒤 붙여넣으면 등록이 끝납니다.
{% hint style="info" %}
MCP 서버 주소는 **`https://gateway.laplacetec.com/mcp`** 입니다.
{% endhint %}
## 연결한 다음에는
* [연결 후 이렇게 물어보세요](/guide/mcp/use.md): 첫 질문과 역할별 질문 예시, AI가 할 수 있는 일
* [문제 해결](/guide/mcp/troubleshooting.md): 연결이 안 되거나 안내 문구가 나올 때
* [보안과 권한](/guide/mcp/security.md): AI가 볼 수 있는 데이터의 범위와 연결 해제 방법
## 전담 매니저에게 요청하기
MCP 연동에 대해서 문의하실 사항이 있으신가요?
하단의 문의하기 혹은 홈페이지의 채팅 상담을 통해 문의하세요. 담당 매니저가 연결을 도와드리겠습니다.
> 💬 [채팅으로 문의하기](https://laplacetec.channel.io/lounge)
>
> 💬 [홈페이지에서 문의하기](https://www.analytics.laplacetec.com/contact)
**이메일 문의:** [**product@laplacetec.com**](mailto:product@laplacetec.com)
