MCP, REST, 앱 내 에이전트

Eidograph는 에이전트를 위한 세 가지 경로를 제공하며, 모두 같은 도구 모음으로 이어집니다.

경로	적합한 용도	사용 가능한 곳
앱 내 에이전트	현재 프로젝트를 자연어로 변경	Windows 및 Android 앱
MCP Streamable HTTP	원격 HTTP MCP를 지원하는 에이전트 플랫폼	Windows 앱
JSON REST API	스크립트, 워크플로, 맞춤형 에이전트	Windows 앱

도구가 스크립트를 바꾸기 전에 Eidograph는 변경 후보를 컴파일합니다. 컴파일러 오류나 건너뛴 명령 경고가 있는 편집은 거부되며 현재 스크립트는 그대로 유지됩니다. 성공한 편집은 즉시 저장되고, 다시 그려지며, 일반 실행 취소 기록에 들어갑니다.

네이티브 서버 켜기

설치된 앱에서 설정 › MCP / REST 서버를 엽니다.
서버를 켜고 상태가 실행 중인지 확인합니다. 기본 포트는 14159입니다.
클라이언트가 필요로 하는 도구만 켭니다.
도형 패널에서 각 도형 옆의 공개 점을 확인합니다. 채워진 점은 외부 클라이언트가 접근할 수 있다는 뜻입니다.
신뢰할 수 있는 네트워크가 아니라면 기본 루프백 바인딩을 유지하세요.

기본 엔드포인트:

txt

MCP   http://127.0.0.1:14159/mcp
REST  http://127.0.0.1:14159/api/v1

DANGER

LAN 모드는 0.0.0.0에 바인딩되며 인터넷 릴레이가 없습니다. 해당 네트워크의 네이티브 클라이언트는 켜 둔 도구를 호출할 수 있으므로, LAN 모드를 켜기 전에 액세스 토큰을 켜고, 신뢰할 수 있는 네트워크에서만 사용하며, 사용 후에는 끄세요.

액세스 토큰 필요로 설정

서버는 기본적으로 인증이 없으며, 루프백에 머무는 동안에는 이미 PC에서 실행 중인 프로그램만 접근할 수 있으므로 충분히 안전합니다. 설정 › MCP / REST 서버 › 액세스 토큰 필요를 켜면(LAN 모드를 켜기 전에 반드시 하세요) Eidograph가 모든 요청에 포함되어야 하는 비밀 값을 생성합니다.

txt

Authorization: Bearer <token>

이것이 없는 요청에는 401이 응답됩니다. 설정에는 복사 버튼과 함께 토큰이 표시되고, 토큰 교체로 새 값으로 바꿀 수 있으며, 끄면 토큰이 지워집니다. 두 동작 모두 즉시 적용되므로 구성해 둔 모든 클라이언트를 갱신하세요.

다른 프로그램에서 서버 찾기

포트는 설정 값이므로 앱 밖에서는 그것을 가정할 수 없습니다. 리스너가 켜져 있는 동안 Eidograph는 검색 파일을 게시하고, 서버가 멈추거나 앱이 종료되면 삭제합니다.

플랫폼	경로
Windows	`%LOCALAPPDATA%\eidograph.metaphor.projects\server.json`
macOS	`~/Library/Application Support/eidograph.metaphor.projects/server.json`
Linux	`$XDG_DATA_HOME/eidograph.metaphor.projects/server.json`

json

{
  "version": "0.2.19",
  "pid": 24680,
  "updatedAt": 1757000000000,
  "bindAddress": "127.0.0.1",
  "port": 14159,
  "mcp": "http://127.0.0.1:14159/mcp",
  "api": "http://127.0.0.1:14159/api/v1",
  "token": "3f9c…",
  "lanAddresses": []
}

mcp 또는 api를 읽고 token을 베어러 토큰으로 보내세요. 필요하지 않으면 token은 null입니다. 이 파일을 읽는 것은 모두 같은 컴퓨터의 프로그램이므로 LAN 모드에서도 게시된 URL은 루프백을 유지합니다. 설정 › MCP / REST 서버에서 정확한 경로를 보여 주고 복사할 수 있습니다. 파일이 없다면 추측한 포트로 대체하지 말고 "서버가 실행 중이 아님"으로 취급하세요.

Claude Desktop

Claude Desktop은 MCP 서버를 로컬 stdio 프로세스로 설치하므로 HTTP URL을 그대로 붙여넣을 수 없습니다. 둘을 연결하려면 eidograph-mcpb 확장 프로그램을 설치하세요. 설정이 필요 없으며 포트와 액세스 토큰을 스스로 찾고 요청할 때마다 다시 읽습니다. 스크린샷이 포함된 단계별 설치 방법과 다른 기기에서 실행 중인 Eidograph에 연결하는 방법은 Claude Desktop을 참고하세요.

MCP 플랫폼 연결

Streamable HTTP를 지원하는 클라이언트(앱이 복사해 주는 Trae / WorkBuddy 구성 포함)에는 다음 서버를 추가하세요.

json

{
  "mcpServers": {
    "Eidograph": {
      "url": "http://127.0.0.1:14159/mcp",
      "transport": "streamable-http",
      "disabled": false
    }
  }
}

플랫폼마다 구성 파일 위치와 바깥쪽 스키마는 다르지만, 핵심 값은 서버 이름, URL, Streamable HTTP 전송 방식입니다. 플랫폼이 로컬 stdio MCP 프로세스만 지원한다면 이 URL을 command 필드에 넣지 말고, 해당 플랫폼이 지원하는 HTTP 커넥터나 브리지를 사용하세요.

연결한 뒤에는 클라이언트가 도구를 탐색하게 하고 현재 스크립트나 명령 레지스트리를 읽으세요. 안정적인 에이전트 순서는 다음과 같습니다.

list_figures로 대상을 확인합니다.
get_script와 list_objects로 현재 도형을 파악합니다.
list_commands로 활성 2D/3D 방언의 유효한 구문을 확인합니다.
추가하는 변경에는 append_commands를, 기존 줄을 다시 써야 할 때만 set_script를 사용합니다.
list_diagnostics로 결과를 검증하고 문제가 있으면 고칩니다.

REST API 호출

엔드포인트 규약, 모든 도구 스키마, 내보내기 인코딩, 오류 동작, JavaScript/Python/PowerShell 예제는 REST API Reference를 참고하세요.

먼저 상태와 도구 탐색을 확인합니다.

bash

curl http://127.0.0.1:14159/api/v1/status
curl http://127.0.0.1:14159/api/v1/tools

점 두 개와 선분 하나를 만듭니다.

bash

curl -X POST http://127.0.0.1:14159/api/v1/tools/append_commands \
  -H "Content-Type: application/json" \
  -H "X-Eidograph-Client: my-agent" \
  -d '{"commands":"point A -2 0\npoint B 2 0\nsegment s A B"}'

응답은 하나의 봉투 형식을 사용합니다. 성공하면 {"ok":true,"result":...}, 실패하면 {"ok":false,"error":...}입니다. 선택 사항인 X-Eidograph-Client 헤더는 설정의 활동 목록에 호출자의 읽기 쉬운 이름을 표시해 줍니다.

현재 인터페이스로는 도형 읽기와 목록 조회, 도형 만들기, 스크립트 추가 또는 교체, 객체/진단/명령 목록 조회, 캔버스에서 객체 선택, 공개된 도형을 SVG, PNG, GIF, MP4로 내보내기를 할 수 있습니다. 도구 권한과 도형 공개 여부는 모든 호출마다 적용됩니다.

앱 내 에이전트 구성

설정 › 에이전트에서 여러 모델을 저장한 다음, 에이전트 헤더에서 전환하세요. Eidograph는 세 가지 프로토콜 계열을 지원합니다.

OpenAI 호환 Chat Completions 엔드포인트.
Anthropic Messages.
Google Gemini / Vertex generateContent.

저장된 각 모델에는 표시 이름, 제공자, 기본 URL, API 키, 모델 ID가 있습니다. 모델 탐색이 실패하면 ID를 직접 입력할 수 있습니다. Ollama, LM Studio 같은 로컬 엔드포인트도 사용할 수 있지만, 엔드포인트가 앱의 WebView에서 오는 교차 출처 요청(CORS)을 허용해야 합니다.

앱 내 에이전트는 첨부하거나 붙여넣은 이미지를 받을 수 있어, 교재 사진이나 스케치를 작도로 바꾸는 데 유용합니다. 비전 지원 여부는 모델 엔드포인트가 결정하며, 지원되지 않는 요청은 대화에 오류로 표시됩니다.

Windows와 Android 앱에서는 에이전트가 웹에서 조사할 수도 있습니다. web_search는 DuckDuckGo로 정리, 작도, 참고 도형을 검색하고, web_fetch는 페이지를 텍스트로 읽거나 URL로 지정한 이미지(예: 재현할 도해)를 확인합니다. 공개 웹사이트에만 접근할 수 있습니다. 이 두 도구는 앱 내 에이전트 전용이며 MCP/REST 인터페이스에는 포함되지 않습니다.

권한과 데이터 경계

앱 내 에이전트와 외부 에이전트에는 숨겨진 특권 경로가 없으며 둘 다 같은 도구 정의를 사용합니다.
외부 편집은 활성 프로젝트를 대상으로 하며 각 도형의 공개 상태를 따릅니다.
API 키는 .eido에 기록되지 않습니다. Windows와 Android 앱은 OS가 보호하는 자격 증명 저장소를 사용합니다.
에이전트 채팅은 기본적으로 .eido에서 제외되며, 에이전트 채팅 포함을 명시적으로 켠 경우에만 공유됩니다.

MCP, REST, 앱 내 에이전트 ​

네이티브 서버 켜기 ​

액세스 토큰 필요로 설정 ​

다른 프로그램에서 서버 찾기 ​

Claude Desktop ​

MCP 플랫폼 연결 ​

REST API 호출 ​

앱 내 에이전트 구성 ​

권한과 데이터 경계 ​