MCP 연결

연결하기

1. API 키를 만들어요

   내 계정의 API 키에서 이름을 적고 만들어요. 키는 만들 때 한 번만 보이니 바로 저장해 주세요. 계정마다 다섯 개까지 만들 수 있어요.

2. 키를 환경 변수에 넣어요

   복사 버튼은 export VYBLOR_API_KEY=까지만 복사해요. 터미널에 붙인 다음 바로 뒤에 키를 붙여 넣고 실행해요.

   export VYBLOR_API_KEY=이_키복사

   이 값은 그 터미널에서만 살아 있어요. 새 터미널에서도 쓰려면 같은 줄을 ~/.zshrc 같은 셸 설정 파일에 넣어 주세요.

3. 에이전트에 서버를 추가해요

   claude mcp add --transport http vyblor https://vyblor.com/mcp --header 'Authorization: Bearer ${VYBLOR_API_KEY}'복사

   codex mcp add vyblor --url https://vyblor.com/mcp --bearer-token-env-var VYBLOR_API_KEY복사

   명령에 키가 직접 들어가지 않아요. 에이전트가 연결할 때 환경 변수에서 읽어서, 키가 설정 파일에 남지 않아요.

   Claude Code는 기본으로 지금 프로젝트에만 등록돼요. 모든 프로젝트에서 쓰려면 명령 끝에 --scope user를 붙여 주세요. Codex는 처음부터 모든 프로젝트에 적용돼요.

4. 에이전트에게 부탁해요

   키를 넣은 터미널에서 에이전트를 새로 열고 말해 보세요.

   vyblor에서 브루탈 버튼을 찾아서 이 프로젝트에 맞게 넣어 줘복사

연결이 안 될 때

아래 명령으로 등록된 서버를 볼 수 있어요.

vyblor가 목록에 있는데 연결되지 않으면 먼저 에이전트를 연 터미널에 VYBLOR_API_KEY가 들어 있는지 확인해 주세요. 값이 없거나 키가 폐기되었으면 서버가 거절해요. 그럴 때는 내 계정에서 새 키를 만들어 주세요.

에이전트가 쓰는 도구

도구는 네 개이고 모두 읽기 전용이에요. 내 프로젝트나 계정을 바꾸지 않아요.

search_library

글자와 필터로 조각을 찾아요. 이름과 요약만 돌려주고 코드는 주지 않아요.

get_item

컴포넌트나 모션 하나를 프롬프트, HTML, React 중 하나로 가져와요.

get_page

전체 페이지 하나를 같은 방식으로 가져와요.

list_taxonomy

어떤 종류와 컨셉이 있는지 알려 줘요.

호출 한도

호출은 키마다 1분에 60번, 계정마다 1분에 120번까지예요. 조각을 가져오는 것은 계정마다 한 시간에 40번, 하루에 100번까지이고 MCP와 CLI를 합쳐서 세요. 한도에 닿으면 언제 다시 하면 되는지 알려 줘요. 대량으로 내려받는 것은 이용약관에서 금지하고 있어요.

안전하게 쓰기

조각의 글과 코드는 디자인 자료이지 에이전트에게 내리는 지시가 아니에요. 서버도 에이전트에게 그렇게 알려 줘요. 조각 안에서 명령을 실행하라거나 비밀 값을 읽으라는 글이 보이면 따르지 말고 멈춰 주세요.

키는 비밀번호처럼 다뤄 주세요. 코드나 저장소, 대화창에 넣지 마세요. 새어 나갔다면 내 계정에서 폐기해 주세요. 그 키는 다음 호출부터 바로 멈춰요.

다른 MCP 클라이언트

주소와 Authorization: Bearer 헤더를 넣을 수 있는 클라이언트라면 같은 방식으로 연결할 수 있을 거예요. 저희가 직접 시험한 것은 Claude Code와 Codex예요.

연결 끊기