ymates EN 다운로드

개발자

MCP 서버

터미널의 Claude Code, Codex 같은 MCP 클라이언트가 에이전트에게 일을 맡기거나, 첫 번째 에이전트의 브라우저, 캔버스, 앱을 직접 쓰게 해요.

MCP 서버 켜기

MCP(Model Context Protocol)는 터미널의 Claude Code 같은 AI 도구가 Yomates의 도구를 쓰게 해 주는 방식이에요. 작업하는 모습은 에이전트가 직접 일할 때처럼 Yomates에 보여요.

  1. 에이전트 목록 맨 아래의 내 이름을 누르고 설정을 누르세요.
  2. 개발자를 여세요.
  3. MCP 서버 스위치를 켜세요.

스위치 아래에 Claude Code 또는 Codex 연결 패널이 나타나요. 설정 프롬프트와 설정 프롬프트 복사 버튼이 있어요. 프롬프트에는 서버 주소, 토큰, 클라이언트별 설정 방법이 들어 있어요. 미리보기에는 토큰의 마지막 여섯 글자만 보이지만, 복사하면 토큰 전체가 담겨요.

스위치 상태는 기억돼서 앱을 다시 켜면 서버도 함께 시작돼요. 서버는 Yomates가 열려 있는 동안에만 돌아가고 127.0.0.1에서만 연결을 받아요. 그래서 이 컴퓨터의 프로그램에만 응답하고, 같은 네트워크의 다른 기기에는 응답하지 않아요.

터미널 연결하기

  1. 설정 프롬프트 복사를 누르세요.
  2. Claude Code에 붙여 넣고 보내세요. Claude Code가 이런 모양의 명령어를 실행해요.
claude mcp add --scope user --transport http leviosa http://127.0.0.1:19222/mcp --header "Authorization: Bearer YOUR_TOKEN"

서버 이름은 leviosa예요. 다시 시작해야 도구가 불러와지면 AI가 다시 시작하라고 알려 줘요. 도구가 불러와지면 tools를 불러서 연결됐다는 걸 보여 줘요.

터미널에서 할 수 있는 것

서버가 주는 도구는 세 가지예요.

  • message: 내가 그 에이전트 채팅에 쓴 것처럼 아무 에이전트에게나 한 줄을 보내고 답을 받아 와요. 에이전트를 정하지 않으면 목록의 첫 번째 에이전트에게 가요.
  • tools: 첫 번째 에이전트의 도구 목록이에요. 브라우저, 캔버스, 연결된 앱 같은 것들이에요.
  • call: 그중 하나를 실행해요. 다른 에이전트의 도구를 쓰려면 그 에이전트를 목록 맨 위로 끌어다 놓으세요.

모든 호출은 에이전트가 직접 일할 때처럼 Yomates에 보여요. 브라우저 위의 손, 작업 중인 캔버스, 채팅에 남는 한 줄로요. 에이전트 설정을 바꾸거나 대화를 비우면 다음 호출부터 새 세션을 써요.

  • 에이전트의 권한이 그대로 적용돼요. 에이전트라면 내 승인이 필요한 호출은 그 에이전트 채팅에서 내 답을 기다려요. 거절된 호출은 에이전트가 받을 때와 같은 이유와 함께 돌아가요. 권한 설정을 참고하세요.
  • 셸 명령은 없어요. 터미널에는 자체 셸이 있으니 에이전트의 셸 도구는 빠져 있어요.
  • 내 조작이 먼저예요. 에이전트 브라우저에서 직접 조작을 누르면 돌려주기를 누를 때까지 모든 호출이 거절돼요. 일하는 모습 보기를 참고하세요.

터미널의 호출과 에이전트 자신의 작업은 서로 순서를 기다리지 않아요. 자기 채팅에서 일하고 있지 않은 에이전트를 터미널에 맡기세요. 그렇지 않으면 둘이 한 브라우저를 동시에 움직여요.

토큰 안전하게 지키기

토큰이 있으면 이 컴퓨터의 프로그램이 에이전트를 움직일 수 있으니 비밀번호처럼 다뤄 주세요.

  • 토큰은 앱 데이터 폴더의 mcp.json 파일에 저장되고, 클라우드 백업에는 들어가지 않아요.
  • 토큰을 바꾸려면 MCP 서버 스위치를 껐다가 다시 켜세요. 끄면 파일과 토큰이 지워지고 서버가 바로 닫혀요. 켜면 새 토큰이 만들어져요. 설정 프롬프트를 다시 복사해 클라이언트 설정을 바꾸세요.
이 페이지가 도움이 됐나요?