MCP 연결하기
AI 코딩 도구에 sayren MCP 서버를 연결하고 연결을 확인하기
AI 코딩 도구가 내 상점을 읽도록 sayren MCP를 연결합니다. sayren MCP는 검증된 템플릿과 상점의 실제 데이터를 주고, 만든 결과를 규칙으로 검사합니다.
상점 조회·관리와 호스팅 사이트 발행만 쓴다면 설치 없이 주소로 연결할 수도 있습니다(설치 없이 MCP 연결하기).
준비
- sayren 상점(시작하기)
- Node.js 22 이상
- MCP를 지원하는 코딩 도구(Claude Code, Cursor, Codex 등)
1. 액세스 토큰 만들기
Sayren 계정(accounts.sayren.io) › 액세스 토큰에서 토큰 만들기를 누릅니다. 상점 플랫폼의 개발자 › 자격 증명 › 액세스 토큰을
눌러도 이 화면으로 이동합니다.
- 토큰 이름을 넣고 아래 표대로 권한을 고릅니다.
- 상점 범위에 연결할 상점을 넣고, 용도는 AI 에이전트용으로 둡니다.
- 만든 토큰을 바로 복사합니다. 한 번만 보입니다.
| 하려는 일 | 필요한 스코프 |
|---|---|
| 쇼핑몰 화면 만들기 | store:r, product:r |
| 주문 조회 | 위에 더해 order:r |
| 방문 분석 조회 | 위에 더해 analytics:r |
| 대화로 데이터 수정 | 바꿀 리소스의 쓰기 스코프(예: product:rw) |
토큰은 계정에 발급되므로 연결할 상점을 SAYREN_STORE_ID로 따로 지정합니다. 토큰의 상점 범위가 상점 하나면 생략할 수 있습니다.
옛 API 토큰(sy_pat_…)은 @sayren/mcp 0.19.0부터 쓸 수 없습니다(인증과 계정 토큰).
토큰이 든 설정 파일을 저장소에 올리지 마십시오. 쓰지 않는 토큰은 Sayren 계정 › 액세스 토큰에서 폐기합니다.
2. 도구에 연결
상점 플랫폼에서 개발자 › 스토어프론트 만들기로 이동합니다(소유자·관리자). 화면 위쪽은 원격 MCP 안내입니다.
- 템플릿 도구가 필요할 때를 펼치고 로컬 MCP 연결에서 도구별 설정을 복사합니다.
SAYREN_STORE_ID는 이 상점의 id로 채워져 있습니다. SAYREN_TOKEN에 액세스 토큰을 넣습니다.
직접 쓸 때는 아래 형식입니다.
Claude Code
실행한 폴더에서만 쓰입니다. 모든 프로젝트에서 쓰려면 --scope user를 붙입니다.
claude mcp add sayren -e SAYREN_TOKEN=액세스_토큰 -e SAYREN_STORE_ID=store_abc123 -- npx -y @sayren/mcpCursor
.cursor/mcp.json(이 프로젝트) 또는 ~/.cursor/mcp.json(모든 프로젝트)에 넣습니다.
{
"mcpServers": {
"sayren": {
"command": "npx",
"args": ["-y", "@sayren/mcp"],
"env": { "SAYREN_TOKEN": "액세스 토큰", "SAYREN_STORE_ID": "store_abc123" }
}
}
}Codex
~/.codex/config.toml에 넣습니다.
[mcp_servers.sayren]
command = "npx"
args = ["-y", "@sayren/mcp"]
env = { SAYREN_TOKEN = "액세스 토큰", SAYREN_STORE_ID = "store_abc123" }다른 환경변수는 MCP 도구 레퍼런스에 있습니다.
3. 연결 확인
도구를 다시 시작하고 "sayren MCP로 내 상점 정보 알려줘"라고 묻습니다.
완료 기준: 에이전트가 get_store_context로 상점 이름·코드·상품 수를 답합니다. 시작하기에서 연결했다면 ④ 연결 완료의
**[연결 완료]**를 누릅니다.
안 되면 MCP 문제 해결을 보십시오.