에이전트에서 사용하기
라이브러리를 MCP 서버로 연결하면 에이전트가 브라우저 없이 디자인을 검색하고 만듭니다.
라이브러리를 MCP 서버로 연결하면 에이전트 안에 그대로 들어옵니다. 이곳을 둘러보고 프롬프트를 복사해 붙여넣는 대신, 페이월 화면을 요청하면 에이전트가 라이브러리를 검색해 일치하는 결과를 보여주고 여러분이 고른 것을 만듭니다. 같은 디자인, 같은 프롬프트, 브라우저는 필요 없습니다.
연결하기
엔드포인트는 https://mcp.clevens.com/mcp입니다. Streamable HTTP를 사용하므로 현재의 어떤 MCP 클라이언트든 로컬 프록시 설치 없이 바로 연결할 수 있습니다. 검색에는 아무것도 필요 없으며, 디자인을 가져오려면 키가 필요한데 이는 계정 페이지에서 만들 수 있습니다. 클라이언트가 순수 호스트 주소인 https://mcp.clevens.com를 원한다면 그것도 작동합니다.
Claude Code
claude mcp add --transport http clevens https://mcp.clevens.com/mcp \
--header "Authorization: Bearer mdc_your_key"Cursor
모든 프로젝트에 적용하려면 ~/.cursor/mcp.json에, 하나의 프로젝트에만 적용하려면 .cursor/mcp.json에 추가하세요:
{
"mcpServers": {
"clevens": {
"url": "https://mcp.clevens.com/mcp",
"headers": { "Authorization": "Bearer mdc_your_key" }
}
}
}VS Code
워크스페이스의 .vscode/mcp.json에 추가하세요:
{
"servers": {
"clevens": {
"type": "http",
"url": "https://mcp.clevens.com/mcp",
"headers": { "Authorization": "Bearer mdc_your_key" }
}
}
}그 외의 경우
stdio만 지원하는 클라이언트는 자체 설치가 필요 없는 mcp-remote로 연결할 수 있습니다:
npx -y mcp-remote https://mcp.clevens.com/mcp --header "Authorization: Bearer mdc_your_key"키 발급받기
여러분의 계정 페이지에서 만드세요. 한 번만 표시되므로 즉시 설정에 붙여넣으세요. 키는 만료되지 않으며 계정당 최대 5개까지 가능하고, 취소하면 즉시 작동을 멈춥니다. 키가 유출되면 취소하고 새로 만드세요. 그 외에 연결된 정보는 없습니다.
에이전트가 얻는 것
| 도구 | 기능 |
|---|---|
| search_designs | 텍스트, 카테고리, 유형, Expo Go 안전성으로 디자인을 찾습니다. 코드가 아니라 메타데이터를 반환합니다. |
| list_categories | 라이브러리가 다루는 모든 카테고리와, 각 카테고리에 게시된 디자인 수. |
| get_design | 디자인 하나를 가져옵니다: 모든 파일의 전체 소스, 의존성, 폰트, 연결 방법. |
| get_designs | 여러 개를 하나의 그룹화된 프롬프트로 가져와, 설정이 디자인마다가 아니라 한 번만 이루어지게 합니다. |
여러 개를 한 번에 요청할 수 있습니다. get_designs가 존재하는 이유는, 세 개의 개별 프롬프트가 있으면 에이전트가 앱 스캐폴딩을 세 번 하고 의존성을 세 번 설치하게 되며, 비슷한 세 개의 화면을 받은 에이전트는 이를 공유 컴포넌트로 합치기 시작하는데, 이는 이 디자인들이 절대 하지 말아야 할 일이기 때문입니다.
하지 않는 것
- 테마를 바꾸지 않습니다. 핸드셰이크는 에이전트가 디자인을 하나라도 보기 전에, 색상, 서체, 여백, 모션이 작성된 그대로 제공된다는 사실을 알려줍니다. 여러분의 팔레트에 맞는 디자인을 원한다면, 그것이 적용되어 작동한 이후 별도 단계로 요청하세요.
- 디자인을 지어내지 않습니다. 일치하는 것이 없으면 근사한 결과를 반환하는 대신 검색이 그렇다고 알려줍니다.
- 여러분의 계정에 쓰기 작업을 하지 않습니다. 모든 도구는 읽기 전용이며, 유일하게 영향을 주는 상태는 여러분의 복사 횟수입니다.
무언가 잘못되었을 때
| 보이는 내용 | 의미 |
|---|---|
| "이 디자인에는 API 키가 필요합니다" | 서버에는 연결되었지만 헤더가 누락되었거나 잘못되었습니다. 설정의 Authorization 헤더를 확인하세요. |
| "일일 한도에 도달했습니다" | 오늘의 무료 할당량을 모두 사용했습니다. 검색은 계속 작동하며, 한도는 협정 세계시(UTC) 자정에 초기화됩니다. |
| "요청이 너무 많습니다" 또는 429 오류 | 이 엔드포인트는 분당 요청 수가 제한되어 있으며, 키가 없는 호출자에게는 더 엄격하게 적용됩니다. Retry-After 헤더가 알려주는 초만큼 기다리세요. 첫 번째 응답을 읽지 않고 검색을 반복하는 에이전트가 흔한 원인입니다. |
| 도구가 전혀 나타나지 않음 | 클라이언트가 핸드셰이크를 완료하지 못했습니다. 재시작한 뒤 URL이 https://mcp.clevens.com/mcp인지 확인하세요. |
| GET 요청에 대한 405 오류 | 예상된 동작입니다. 서버는 POST 요청에만 응답하고 메시지를 먼저 보내는 일이 없으며, 일부 클라이언트는 먼저 이를 확인해 봅니다. |