실행되는 장소는 이전과 동일하게 사용자의 리포지토리 GitHub Actions입니다. 채팅 클라이언트가 요청을 보내기만 합니다.
출처
호스트형 서버는 브라우저에서 Aeon 에이전트를 구동하는 Aeon Connect의 일부입니다. 리포지토리가 공식적으로 이 서버를 안내하기 시작한 것은 2026-10-07(#1192)이며, CHANGELOG에서는 서버 본체를 aeon-connect #66 / #68로 하고 있습니다. 서버 코드는 Aeon Connect 측 프로젝트에 있으며, aeonfun/aeon에는 포함되어 있지 않습니다. 따라서 본 기사의 내용은 메인 리포지토리가 문서화하는 범위 — CHANGELOG, apps/mcp-server의 README, 보안 정책, llms.txt — 에 한정됩니다. 사용자 수 등의 수치는 공개되지 않았으므로 기재하지 않았습니다.
**어떤 것인가요?**
전송(Transport)은 Streamable HTTP이며, 인증은 OAuth 2.1(Dynamic Client Registration, PKCE, GitHub 사인인)입니다. 즉, 원격 MCP 서버에 대응하는 클라이언트라면 설정 파일도 API 키도 로컬 설치 없이 추가할 수 있습니다.
절차는 3단계입니다.
1. **URL 추가하기.** ChatGPT, Claude, Cursor에서는 https://www.aeon.fun/connect/mcp를 커스텀 커넥터(커스텀 MCP 서버)로 추가합니다. Claude Code의 경우 명령어 한 번으로 가능합니다.
`claude mcp add --transport http aeon https://www.aeon.fun/connect/mcp`
2. **GitHub에 사인인하기.** 처음 서버가 필요할 때, 클라이언트가 OAuth 플로우를 엽니다.
3. **에이전트 선택하기.** 동의 화면에서 이 클라이언트가 접근할 수 있는 Aeon 리포지토리를 선택합니다. 이 선택이 클라이언트가 할 수 있는 모든 범위가 됩니다.
Aeon 인스턴스를 여러 개 운영하는 경우, `switch_instance` 도구로 세션을 다른 리포지토리로 전환할 수 있습니다. 전환할 때마다 GitHub 측의 확인을 다시 하기 때문에, 오래된 권한 부여에 의존할 필요가 없습니다.
**채팅에서 할 수 있는 것**
도구는 약 20개 정도 있습니다. 용도별로 정리하면 다음과 같습니다.
* **실행하기.** 에이전트의 스킬 목록을 가져와 `run_skill`로 실행합니다. 실행은 리포지토리 자체의 GitHub Actions에 디스패치되며, 스케줄 실행과 동일한 러너(runner), 하네스(harness)・모델・시크릿(secrets)으로 작동합니다.
* **읽기.** 최근 실행 기록, 에이전트 출력, git에 커밋된 메모를 읽을 수 있습니다. '어젯밤 에이전트는 무엇을 했는지' 채팅을 벗어나지 않고 답할 수 있습니다.
바꿀 수 있습니다. 스킬(update_skill), 에이전트의 정책(update_strategy), 말투(update_soul)를 편집할 수 있습니다. 후자의 두 가지는 Give Your Agent a SOUL.md와 STRATEGY.md에서 설명된 파일입니다.
추가할 수 있습니다. install_pack으로 스킬 팩을 설치합니다.
확인할 수 있습니다. setup_status는 에이전트의 설정 상태(어떤 키가 설정되었는지 포함)를 표시합니다. 표시되는 것은 키 이름만이며, 값은 절대 출력되지 않습니다.
작은 추가 기능도 하나 있습니다. 스킬 단계나 Connect 도구가 실패했을 때, 에이전트는 send_feedback을 통해 짧은 보고서를 1건 보낼 수 있습니다(secrets나 비공개 리포지토리의 내용은 절대 포함하지 않습니다). 이러한 보고서는 Feedback Builder 스킬이 검토 가능한 PR로 변환하는 종류의 입력입니다.
사용 예시는 이렇습니다. Claude에서 출시 관련 상담을 하는 도중에, 내일 07:00이 아니라 회의 전에 경쟁사 다이제스트가 필요해졌다고 가정합니다. 요청하면 Claude가 run_skill을 호출하고 사용자의 Actions를 통해 실행이 시작됩니다. 같은 대화 안에서 출력이 도착하면 읽을 수도 있고, 메모리를 읽어 지난주에 에이전트가 무엇을 결론지었는지 확인할 수도 있습니다. 전략이 잘못되었다면, 그 자리에서 수정할 수 있습니다.
불가능한 것
자신의 인프라 위에서 실행을 시작할 수 있는 도구의 경우, 기능 목록보다 제약 사항이 더 중요합니다. 제약 사항은 보안 정책에 명시되어 있습니다.
secrets의 값은 읽거나 쓸 수 없습니다. 키를 반환하는 도구나 키를 설정하는 도구도 없습니다. Aeon Connect로 연결된 키는 리포지토리의 암호화된 Actions secrets에 직접 저장되며, Aeon Connect 측에는 저장되지 않습니다. setup_status는 ANTHROPIC_API_KEY가 존재한다는 것은 알려주지만, 내용은 알려주지 않습니다. 즉, 채팅에 키를 붙여넣어 에이전트를 설정하는 것도 불가능합니다. 이는 의도적인 설계로, 채팅 기록은 인증 정보를 보관할 장소가 아니기 때문입니다.
한 번의 승인으로 1개의 리포지토리, GitHub App은 1개입니다. 클라이언트가 접근할 수 있는 것은 동의 화면에서 승인한 리포지토리뿐이며, 경로는 브라우저 대시보드와 동일한 Aeon Connect GitHub App을 사용합니다. 이 App은 하나의 리포지토리에 설치되며, 리포지토리 레벨의 권한만 요청합니다. 쓰기 계열 도구(run_skill, update_skill, update_strategy, update_soul, install_pack)는 해당 리포지토리에만 작용합니다. 이러한 설계는 최소 권한 원칙(Least Privilege for an Autonomous Agent)과 같은 원칙 — 에이전트에게도, 그리고 이번에는 채팅 클라이언트에게도, 업무에 필요한 범위만큼만 부여하는 것 — 을 따릅니다.
접근은 만료되며 쉽게 취소할 수 있습니다. 사용되지 않은 접근은 30일 후에 만료됩니다. 즉시 끊으려면 Aeon Connect GitHub App을 제거하거나, App에서 리포지토리를 제외해야 합니다.
공개 에이전트를 비공개로 만들 수는 없습니다. 인스턴스가 public fork라면, memory/, output/, 실행 로그는 MCP 유무와 관계없이 공개됩니다. 대처 방법은 커넥터가 아니라 그 이전 단계에서, 인스턴스를 private 리포지토리로 만드는 것입니다(GitHub는 public 리포지토리의 private fork를 허용하지 않으므로, 템플릿에서 생성된 복사본이 됩니다).
호스트형과 로컬형 — Aeon의 MCP 서버는 2가지가 있습니다
호스트형은 새로운 것이지만, Aeon에는 이전부터 Local의 MCP 서버가 apps/mcp-server에 존재합니다(이전 기사 aeon on the Wire: MCP and a Fleet of Forks에서 소개되었습니다). 둘은 해결하는 문제가 다릅니다.
호스트형 (Aeon Connect)
로컬형 (apps/mcp-server)
추가 방법
bin/add-mcp
전송(Transport)
Streamable HTTP, OAuth 2.1, GitHub Sign-in
stdio
지원 클라이언트
ChatGPT, Claude, Claude Code, Cursor, 임의의 원격 MCP 클라이언트
Claude Code, Claude Desktop
스킬 실행 위치
리포지토리의 GitHub Actions
사용자 기기(harness-adapter/run-harness 경유)
도구
약 20개: 실행·읽기·편집·설치·전환
스킬마다 aeon- 도구가 1개씩 존재합니다.
필요한 것
Aeon Connect GitHub App을 추가한 Aeon 리포지토리
클론, Node, 로그인된 harness CLI, 스킬용 키
로컬 서버는 catalog/skills.json을 읽어 모든 스킬을 개별 도구(aeon-digest, aeon-pr-review 등)로 만듭니다. 각 도구의 입력은 생략 가능한 var 1개만 있습니다. 호출하면 스케줄 실행과 동일한 SKILL.md 프롬프트가 같은 tier·도구·모델 해결로 실행되며, 타임아웃도 CI와 같은 30분입니다. 최근 수정 사항 중 알아두면 좋은 것이 두 가지 있습니다. 여러 줄의 var가 한 줄로 접히게 된 것(#1204), 그리고 실패한 스킬 실행이 성공으로 보이지 않고 MCP의 오류 결과로 반환되게 된 것(#1209)입니다.
'호스트형을 선택하는 경우'는 ChatGPT나 Cursor에서 사용하고 싶거나, 아무것도 설치하고 싶지 않거나, 에이전트 본연의 인프라에서 실행하고 싶을 때입니다. '로컬형을 선택하는 경우'는 스킬을 하나씩 별도의 도구로 다루고 싶거나, 자신의 기기와 자신의 키로 스킬을 구동해도 괜찮은 경우입니다.
둘 다 사용하는 경우. bin/add-mcp는 로컬 서버를 aeon이라는 이름으로 등록하고, 그 전에 claude mcp remove aeon을 실행합니다. 이는 동명의 호스트형 엔트리를 삭제해 버립니다(스크립트는 감지 시 경고를 출력합니다). 둘 다 남겨두려면, 호스트형을 다른 이름으로 등록해야 합니다.
claude mcp add --transport http aeon-cloud https://www.aeon.fun/connect/mcp
Aeon MCP 서버에 연결할 수 있는 AI 클라이언트는 무엇인가요? Streamable HTTP와 OAuth를 지원하는 원격 MCP 서버를 지원하는 클라이언트라면 연결할 수 있습니다. 리포지토리에서 언급된 것은 ChatGPT, Claude, Claude Code, Cursor입니다.
에이전트는 Aeon의 서버에서 작동하나요? 아닙니다. 스킬은 사용자의 리포지토리 GitHub Actions에서 작동합니다. Aeon Connect가 호스팅하는 것은 대시보드와 MCP 엔드포인트이며, 에이전트 본체가 아닙니다.
MCP 서버에서 API 키를 읽을 수 있나요? 읽을 수 없습니다. secrets의 값은 읽기/쓰기 모두 불가능합니다. setup_status가 반환하는 것은 키 이름뿐입니다.
접근을 취소하려면요? Aeon Connect GitHub App을 제거하거나, App에서 리포지토리를 제외하면 됩니다. 사용되지 않는 접근 권한은 30일 후에 자동으로 만료됩니다.
먼저 Aeon 에이전트가 필요한가요? 예. 브라우저에서 www.aeon.fun/connect를 통해 만들거나, 리포지토리를 클론하여 ./aeon init을 실행한 후 커넥터를 추가해야 합니다.
관점을 바꾸자면
지금까지 상시 가동 에이전트와 대화하는 방법은 두 가지였습니다. 스케줄을 기다리거나, 대시보드를 여는 것이었습니다. MCP 서버는 세 번째 — 지금 있는 곳에서 요청하기 — 를 추가합니다. 에이전트는 자신의 인프라·메모리·키를 계속 보유하고 있고, 채팅 클라이언트는 범위가 제한된 취소 가능한 핸들만 받습니다. 이 분리가 바로 자율 에이전트를 범용 어시스턴트와 연결해도 안전한 이유입니다. 어시스턴트는 에이전트를 조종할 수 있지만, 에이전트의 열쇠를 가지지는 못합니다.
시리즈 기사(원문·영어)
Aeon Connect: start your agent from the browser — 브라우저만으로 Aeon 에이전트를 시작하는 방법
Give Your Agent a SOUL.md and STRATEGY.md — 에이전트의 말투와 방침을 파일로 정의하기
자율 에이전트에게 최소 권한(Least Privilege)을 적용하는 설계
피드백 빌더(Feedback Builder) — 에이전트가 보고한 버그를 검토 가능한 PR로 전환합니다.
aon on the Wire: MCP와 포크 군단(Fleet of Forks) — 로컬 MCP 서버와 포크들의 이야기
번역자 코멘트
코드부터 시작하고 싶은 분들은 먼저 apps/mcp-server/README.md의 호스트형/로컬형 비교표를 보고, 로컬형이라면 bin/add-mcp --build-only 명령어로 빌드만 진행한 뒤 python docs/examples/mcp/test_connection.py로 왕복 연결을 확인하는 것이 가장 빠릅니다. 스킬 본체는 skills/ 아래에 있으며, 1 스킬 = 1 SKILL.md입니다.
저장소: aeonfun/aeon (MIT 라이선스)
원문: Aeon MCP Server: ChatGPT 또는 Claude에서 에이전트를 구동하세요
오역이나 부정확한 점이 있다면 댓글로 지적해 주시면 감사하겠습니다.
