MCP로 geul 연결하기
AI 도구에서 글을 읽고, 작업 기록을 정리해 발행합니다.
계정 준비
geul에 로그인하고 프로필을 만듭니다. 브라우저에서 쓰는 글과 AI 도구로 작성한 글은 같은 계정에 모입니다.
연결 주소 등록
사용하는 AI 도구에 아래처럼 요청합니다.
https://geul.io/mcp 를 MCP 서버로 등록해줘.Claude Code, Codex CLI, Command Code는 원격 HTTP 서버로 등록하고 브라우저 인증을 진행합니다. 클라이언트 ID 발급이나 콜백 포트 지정은 필요하지 않습니다.
Pi는 MCP 기능이 기본으로 포함되어 있지 않습니다. pi-mcp-adapter 확장을 설치한 뒤 같은 주소를 등록합니다. 처음 연결할 때는 확장 설치와 재시작이 필요할 수 있습니다.
로그인과 권한 확인
연결 과정에서 열리는 브라우저에서 로그인하고 권한을 확인합니다. 읽기 권한은 공개 글 조회와 검색에, 쓰기 권한은 글 작성과 수정, 삭제, 이미지 업로드에 쓰입니다. 수정과 삭제는 본인 글만 가능합니다.
글 조회부터 확인
연결 후 AI 도구에 아래처럼 요청합니다.
geul에서 내가 쓴 글 목록을 보여줘.
목록을 읽을 수 있다면, 공개할 내용을 확인하고 글 작성을 요청합니다.
이번 작업에서 배운 점을 글로 정리해줘. 제목과 본문을 먼저 보여주고, 내가 확인하면 geul에 발행해줘.
본문은 Markdown입니다. 글을 쓸 공간을 선택하고, 필요하면 공간 안의 분류도 지정합니다. 이미지는 upload_image 도구에 공개 URL 또는 Base64 문자열로 올린 뒤 반환된 Markdown을 본문에 넣습니다.
연결이 안 될 때
- 로그인 성공 후에도 글 도구가 표시되는지 확인합니다. 로그인과 도구 연결은 별도 단계입니다.
- 도구가 OAuth 로그인과 자동 클라이언트 등록을 지원하는지 확인합니다. 별도 SSE 연결만 지원하는 클라이언트는 연결할 수 없습니다.
- 이전에 등록에 실패했다면 해당 서버의 인증 정보를 지우고 다시 연결합니다.
- 프로필이 필요하다는 응답이 오면 geul에서 프로필을 만든 뒤 다시 시도합니다.
- 글 작성 응답이 끊겼다면 목록을 먼저 조회합니다. 재시도하면 같은 글이 두 번 게시될 수 있습니다.