ChatGPT에서 Eidograph 연결하기
ChatGPT 데스크톱 앱은 MCP를 통해 Eidograph의 도형을 직접 읽고 수정할 수 있습니다. 이 안내서는 같은 Windows 컴퓨터에서 실행하는 Eidograph와 ChatGPT 데스크톱 앱을 Streamable HTTP로 연결하는 방법을 설명합니다.
스크린샷은 영어 인터페이스에서 실제로 설정한 화면이며, 비교하기 쉽도록 항목 이름을 그대로 표기했습니다. 도구는 Eidograph의 로컬 서버에 접근할 수 있는 환경에서 실행해야 합니다. 원격 또는 클라우드 환경의 127.0.0.1은 사용자의 Windows 컴퓨터를 가리키지 않습니다.
1. Eidograph 서버 시작하기
- 설치된 Eidograph 앱에서 설정 › MCP / REST 서버를 열고 서버를 켠 다음 실행 중인지 확인합니다.
- 설정에 표시된 전체 MCP 주소를 복사합니다. 기본값은
http://127.0.0.1:14159/mcp입니다. 포트를 변경했다면 실제로 표시되는 주소를 사용하세요. - 필요한 도구를 활성화합니다. 도형 패널에서 대상 도형 옆의 공개 표시 점이 채워져 있어야 외부 클라이언트가 접근할 수 있습니다.
- 연결하는 동안 Eidograph를 실행 상태로 유지합니다. 같은 컴퓨터에서는 기본 로컬 수신 설정으로 연결할 수 있습니다.
2. ChatGPT에 MCP 추가하기
Settings → Plugins → MCPs를 열고 오른쪽 위의 Add에서 Add MCP server를 선택합니다.

Connect to a custom MCP 양식을 다음과 같이 작성합니다.
| 항목 | 값 |
|---|---|
| Name | eidograph |
| Type | Streamable HTTP |
| URL | Eidograph 설정에 표시된 전체 MCP 주소. 예: http://127.0.0.1:14159/mcp |
URL 끝의 /mcp를 유지하세요. /api/v1은 REST API 주소이며 이 양식에 필요한 MCP 엔드포인트가 아닙니다.
Eidograph에서 액세스 토큰 필요를 켰다면 Headers에 키 Authorization과 값 Bearer <token>을 추가하고, <token>을 실제 토큰으로 바꿉니다. 토큰 인증이 꺼져 있다면 이 헤더는 필요하지 않습니다.
Bearer token env var에는 토큰 자체가 아닌 환경 변수 이름을 입력합니다. ChatGPT 실행 환경에 해당 변수가 설정되어 있을 때만 사용하고, 헤더를 직접 지정하는 경우에는 비워 두세요.

3. 저장하고 연결 활성화하기
Save를 클릭합니다. MCPs 목록에 eidograph가 표시되고 스위치가 켜져 있는지 확인하세요. 클라이언트에서 다시 로드하거나 재시작하라는 안내가 나오면 해당 작업을 완료한 뒤 새 Work 대화를 열어 도구를 사용합니다.

4. 먼저 읽고 나서 작도하기
대상 도형을 확인하기 위해 읽기 전용 요청부터 보냅니다.
eidograph 커넥터만 사용해 주세요.
list_figures로 접근 가능한 도형을 나열하고 get_script로 현재 스크립트를 읽어 주세요.
도형을 간단히 설명하고, 아무것도 수정하거나 내보내지 마세요.반환된 도형 이름과 스크립트를 확인한 다음 작도를 요청할 수 있습니다.
eidograph로 별도의 2D 도형을 만들고 다른 도형은 변경하지 마세요.
이등변삼각형 ABC를 그리고 BC에 종속되는 중점 M을 만든 뒤 AM을 연결해 주세요.
검은 선과 읽기 쉬운 꼭짓점 이름을 사용하고 AM은 파선으로 표시해 주세요.
먼저 list_commands로 문법을 확인하고 완성 후 list_diagnostics로 검사해 주세요.
학생용 시험지이므로 직각 표시나 증명 정답은 넣지 마세요.완성 후 실제 캔버스, 이름 표시, 진단을 확인합니다. 서버 설정의 최근 외부 활동에서도 도구 호출을 대조할 수 있습니다. ChatGPT 작업 환경이 문서 생성을 지원한다면 도형 이미지를 가져와 DOCX를 만들고, 대화에서 클릭해 열 수 있는 파일로 제공하도록 요청할 수 있습니다. 저장 경로를 지정할 필요는 없습니다. Eidograph 도구는 이미지를 제공하고 ChatGPT 작업 환경이 문서를 생성합니다.
5. 연결 문제 해결하기
- 연결할 수 없음: 앱과 서버가 실행 중인지, URL과 포트가 일치하는지, 도구 실행 환경에서 이 컴퓨터에 접근할 수 있는지 확인합니다.
401응답: 토큰과Bearer접두사를 확인합니다. 환경 변수 이름 칸에 실제 토큰을 입력하지 마세요.- 대상 도형이 보이지 않음: 활성 프로젝트, 도형의 공개 표시 점, 도구 권한을 확인합니다.
- 수정 사항이 적용되지 않음: 활성 도형을 확인하고
list_diagnostics와 외부 활동의 오류에 따라 요청을 수정합니다.
도구와 권한은 MCP, REST 및 앱 내 에이전트와 REST API 참조를 참고하세요. ChatGPT 메뉴와 연결 기능은 현재 클라이언트를 기준으로 하며, OpenAI 공식 MCP 문서에서도 확인할 수 있습니다.
