Agenvoy: 당신이 익숙한 Agent가 직접 도구를 만들게 하세요

Agenvoy - 당신의 로컬 머신에서 실행되는 개인용 AI Agent입니다. 도구를 구축하고, 테스트하고, 호출하세요.

많은 사람들이 프로그래밍을 돕거나, 정보를 검색하거나, 파일을 처리하기 위해 Agent를 사용합니다. Claude Code, Codex, Cursor, 또는 Hermes 및 OpenClaw와 같은 도구들은 모두 MCP 연결을 지원합니다.

MCP를 "Agent의 만능 주머니"라고 생각해보세요. 이를 통해 Agent는 필요할 때 날씨 확인, 파일 읽기, 네트워크 API 호출 등과 같은 적절한 도구를 꺼내어 작업을 수행할 수 있습니다.

하지만 대부분의 만능 주머니는 기본적으로 고정된 도구만을 제공합니다. 주머니를 제공하는 사람이 주는 것만 Agent가 사용할 수 있습니다. 만약 적절한 도구가 없다면? Agent는 당신에게 "할 수 없습니다"라고 말할 수밖에 없습니다.

이제 핵심입니다, Agenvoy는 다릅니다.

속담에 "물고기를 잡아주는 것보다 물고기 잡는 법을 가르쳐주는 것이 낫다"라는 말이 있습니다.

그래서 저는 도구를 만드는 도구와, 그것을 어떻게 사용하는지에 대한 사용 설명서를 제공합니다. 🤣
당신의 Agent가 필요할 때 설명서를 참고하여 부족한 도구를 스스로 직접 만들 수 있게 합니다.

또한 Agent에 국한되지 않습니다. 당신이 사용하는 Agent가 MCP를 지원하기만 한다면, Claude Code, Codex 또는 다른 Agent라도 Agenvoy를 연결하면 "자체 도구 구축" 능력을 얻을 수 있습니다.

예시

오늘 당신이 Agent에게 다음과 같이 질문합니다:

현재 AAPL의 주가를 알려줘

정상적인 경우, 현재 주식 조회 도구가 없다면 성능이 좋은 Agent는 Search Web을 통해 여러 웹페이지를 크롤링하여 답을 줄 수도 있지만, 대부분의 일반적인 Agent는 "대응하는 도구가 없습니다"라고 답변할 것입니다.

하지만 오늘 Agenvoy MCP를 추가했다면, 당신의 Agent는 다른 경로를 택할 것입니다.

Q: 현재 AAPL의 주가를 알려줘
  ↓
기존 도구 검색 → 일치하는 항목 없음
...

이 모든 과정은 동일한 대화 내에서 구현됩니다. 당신은 단지 요구사항을 말하기만 하면 되며, 코딩 능력이 필요하지 않습니다. Agent가 당신에게 질문하고 확인하기를 기다리기만 하면 됩니다.
（ps. Codex는 제외, Codex는 강제적인 경로를 따르지 않으므로 직접 도구를 제작하라고 명령해야 합니다）

그리고 이 작업에는 두 가지 아주 멋진 점이 있습니다:

1. 이 프로세스가 완료되면, 이 도구는 영구적으로 저장됩니다. 다음에 만약 "TSLA는 얼마야?"라고 묻는다면, Agent는 즉시 준비된 도구를 사용하여 조회할 것입니다.
2. 동일한 호스트 상의 다른 Agent에서도 이 도구는 즉시 공유됩니다. Claude Code에서 만든 도구를 다음 순간 Codex에서 바로 사용할 수 있습니다.

어떻게 즉시 사용할 수 있나요?

Agenvoy는 표준 MCP 프로토콜을 따릅니다. MCP를 지원하는 모든 AI 도구는 각 Agent의 안내에 따라 설정하여 연결할 수 있습니다:

{ "mcpServers": { "agenvoy": { "command": "agen" } } }

연결에 성공하면, 당신이 사용하는 Agent는 Agenvoy가 제공하는 모든 도구를 볼 수 있게 됩니다. 여기에는 다음이 포함됩니다:

• 이미 존재하는 도구 (이전에 구축했거나 시장에서 설치한 도구)
• 새로운 도구를 구축하는 능력 (가이드 읽기, 도구 작성, 테스트, 수정)

Agenvoy는 당신이 사용 중인 Agent를 포기하게 만들려는 것이 아니라, 기존의 Agent를 더 강력하게 만들기 위한 것입니다.

도구는 어떻게 만드나요?

Agent 부분에 대해, Agenvoy는 완전한 "도구 구축 가이드"를 제공하여 Agent에게 각 도구가 어떻게 구성되어야 하는지 알려줍니다. 도구는 주로 두 개의 파일로 구성됩니다:

tool.json    →  사용 설명서 (이 도구가 무엇을 하는지, 어떤 파라미터가 필요한지)
script.py    →  코드 (Py/Js 지원)

가이드를 다 읽고 나면, Agent는 요구사항과 형식에 따라 이 두 파일을 작성하여 지정된 폴더(~/.config/agenvoy/tools/script)에 넣습니다. Agenvoy는 이를 사용 가능한 도구로 자동으로 등록합니다.

또한 폴더 내의 파일들을 백업해 두기만 하면, Agenvoy가 설치된 모든 장치로 가져가서 동일한 도구를 즉시 사용할 수 있습니다 (또는 Agenvoy가 제공하는 마켓플레이스에 업로드하여 다른 사람들이 다운로드할 수 있게 할 수도 있습니다).

직접 만들 수 있나요?

물론입니다. 코딩 능력이 있다면 동일한 형식으로 파일을 새로 만들어 폴더에 넣기만 하면 당신의 Agent가 즉시 호출할 수 있습니다. 아래에 두 가지 예시를 제공합니다:

• fetch_weather
• fetch_crypto_price

보안성

보안성

직접 구축한 도구는 사용자의 컴퓨터에서 그대로 노출되어 실행되지 않습니다. 모든 도구의 실행은 OS 계층의 샌드박스 격리 (Sandbox Isolation)를 거치며, SSH 키, 클라우드 자격 증명 (Cloud Credentials), 환경 변수 (Environment Variables) 등을 포함한 민감한 디렉토리에 대한 접근은 모두 금지됩니다.

요약

Agenvoy v0.27.* 버전부터는 사용자가 익숙한 Agent가 대화 과정에서 스스로 새로운 도구를 생성, 테스트 및 저장할 수 있습니다.

사용자는 도구를 바꿀 필요도, 새로운 조작법을 배울 필요도 없이, 그저 Agenvoy의 MCP를 연결하기만 하면 됩니다.