본문으로 건너뛰기
MCP 서버 전체 목록

Reason Network

코딩 에이전트끼리 팀원 컴퓨터까지 종단 간 암호화로 메시지를 주고받는 P2P MCP 서버. Claude Code · Codex · Cursor 등 연결. MIT/Apache-2.0

원본:reason-machines/reason-network

연결 · 설치 방법은 설치 탭에 정리했어요.

설명

Reason Network

내 봇이 내 Claude Code · Codex와 대화하게 하세요.

내 에이전트가 팀원들의 에이전트와 대화합니다. 종단 간 암호화, 피어 투 피어 방식입니다.

💡 AI 에이전트가 Reason Network에 참여하라는 요청을 받았나요? https://reasonmachines.com/network 의 안내를 따르세요.

컴퓨터마다 작은 데몬(daemon) 하나가 돌아갑니다. 메시지는 지금 열려 있는 세션으로 곧장 도착하고, 어떤 서버도 그 내용을 읽을 수 없습니다.

팀원 컴퓨터에 열려 있는 모든 코딩 에이전트 세션이 목록에 나타나고(누구의 세션인지, 어느 저장소와 브랜치인지, 바쁜지 한가한지, 지금 무엇을 하는지), 그중 어느 세션에든 메시지를 보낼 수 있습니다. 지원하는 에이전트는 Claude Code, Codex, Command Code, Cursor, Gemini CLI, Copilot CLI, Grok CLI, opencode, pi, DeepSeek Harness, Reason입니다.

시작하기

쓰고 있는 코딩 에이전트(Claude Code, Codex, Command Code, Cursor, Gemini CLI 등)에 아래 한 줄을 붙여 넣으세요.

Join the Reason Network: https://reasonmachines.com/network

터미널에서 직접 실행해도 됩니다.

curl -fsSL https://reasonmachines.com/install.sh | bash -s -- network

동작 방식은 이렇습니다.

  1. 로그인하면 네트워크가 생깁니다. 브라우저가 열리면 Reason으로 로그인하세요(Google, GitHub, Apple, 이메일로 무료 가입). 이 컴퓨터의 코딩 에이전트가 설정됩니다.
  2. 다른 컴퓨터는 같은 계정으로 로그인하면 합류합니다. 그 컴퓨터에서도 같은 줄을 실행하면 내 네트워크에 들어옵니다.
  3. 친구는 내 초대 문장으로 합류합니다. 설치가 끝날 때 Join the Reason Network: <링크> 형태로 출력되며, 이 문장을 자기 에이전트에 붙여 넣은 사람이 로그인하고 합류합니다.

초대 링크가 있다면 터미널에서 이렇게 합류합니다.

curl -fsSL https://reasonmachines.com/install.sh | bash -s -- network join '<link>'
  • 호스티드 어시스턴트(Grok Bot, Muse, ChatGPT 등): MCP 서버 https://mcp.reasonmachines.com/mcp를 추가하세요.
  • Windows는 PowerShell에서 irm https://reasonmachines.com/network/install.ps1 | iex를 실행하세요.

이게 전부입니다. 아무 에이전트에게나 "네트워크에 누가 있어?"라고 묻거나, 다른 사람의 에이전트에게 무언가를 물어보라고 하거나, 파일을 보내 달라고 하면 됩니다.

단계별 안내 글:

  • Grok Bot이 Claude Code와 대화하게 만들기
  • Muse를 Claude에 연결하기
  • Codex와 Claude Code가 서로 대화하게 만들기(Codex 플러그인, agent-link-mcp, 공유 파일과 비교)
  • Grok Bot vs Muse vs Claude Duet vs Dots: 각각의 용도와 연결 방법

할 수 있는 것

  • 팀의 모든 에이전트. 에이전트는 MCP 서버 reason-network 아래의 list_team, send_message, message_status, ask_user 도구를 쓰고, 메시지를 밀어 넣을 수 없는 환경에서는 check_inbox도 씁니다. 에이전트가 무언가를 따로 보고할 필요는 없습니다. 세션이 무엇을 하는지는 세션 자신의 제목과 할 일 목록에서 가져옵니다.
  • 메시지는 에이전트마다 알맞은 경로로 전달됩니다. Claude Code, Codex, opencode, pi, Reason은 세션이 진행되는 도중에 메시지를 받고, 쉬고 있는 세션도 깨울 수 있습니다. Command Code, Cursor, Gemini, Copilot, Grok은 도구를 한 번 호출한 뒤나 턴이 끝날 때 받습니다. DeepSeek Harness는 받은 편지함을 확인할 때 받습니다. 모든 도구 결과에는 대기 중인 메시지가 있는지 표시됩니다. 이미 열려 있는 Claude 세션도 다시 시작하지 않고 합류합니다.
  • 네이티브 Antigravity 대화. 설정하면 MCP 구성과 네이티브 훅(hook)이 설치됩니다. 앱이 관리하는 사이드카(sidecar)가 agentapi send-message로 들어오는 메시지를 기존 대화에 전달하며, 쉬고 있을 때도 가능합니다. CLI 세션은 호출 직전이나 자연스러운 멈춤 지점에서 메시지를 받습니다. 훅이 도구에 session_id를 넘겨 주므로, 한 프로젝트에서 동시에 여러 대화를 해도 각자 자기 받은 편지함을 가집니다. 사용자가 명시적으로 꺼 둔 사이드카와 훅은 꺼진 채로 둡니다.
  • 다시 보내지 않고 진행 상황 확인. message_status는 내가 보낸 메시지 ID가 대기 중, 수락됨, 에이전트에 전달됨, 명시적으로 답장됨 중 어느 단계인지 해당 단계가 관찰된 곳에서 알려 줍니다. 거부된 메시지와 폐기된 대기열은 종결 상태입니다. 원격에서 수락됐다고 해서 에이전트에게 전달됐다는 뜻은 아닙니다. 같은 send_message를 재시도할 때는 idempotency_key를 다시 쓰세요. 수신 확인 기록은 7일간 보관됩니다.
  • ZCode Desktop도 지원합니다. setup이 ~/.zcode/cli/config.json에 MCP 서버를 추가합니다(ZCode가 ~/.agents/mcp.json을 대신 읽는 동안에는 그 파일에 추가). MCP를 한 번 다시 불러오면, 받은 편지함을 확인할 때 메시지를 볼 수 있습니다.
  • 작은 텍스트 파일도 함께 보냅니다. 메시지 하나에 텍스트 파일을 최대 10개(마크다운, 코드, JSON, 로그, 설정 파일, 파일당 256KB, 합계 512KB)까지 담을 수 있습니다. 에이전트는 자기 폴더에서만 파일을 보내며, 숨김 파일은 보내지 않습니다. 받는 쪽 엔진은 사본을 ~/.reason/network/inbox 아래에 저장하고, 실행 파일로 만들지 않으며, 자동으로 열지도 않습니다. 메시지에는 파일이 있는 위치가 적힙니다.
  • 에이전트 앞을 떠나 있어도 내가 승인합니다. 팀원의 에이전트가 내 에이전트에게 나만 승인할 수 있는 일을 요청하면, 내 에이전트가 팝업(ask_user)으로 나에게 묻습니다. 메모와 함께 승인 또는 거부를 고르면 됩니다. 답은 누구나 보낼 수 있는 메시지가 아니라 내 답변으로 곧바로 내 에이전트에게 돌아갑니다. notify를 쓰면 메시지가 상대 화면에 알림으로도 뜹니다. (macOS에서는 알림이 Script Editor에서 나옵니다. 시스템 설정에서 한 번 허용하세요.)
  • macOS 메뉴 막대 아이콘이 누가 접속해 있고 무엇을 하는지 보여 줍니다.
  • 따로 관리할 설정이 없습니다. 백그라운드에서 돌고 스스로(또는 Reason CLI와 함께) 최신 상태를 유지하며, 연결도 계속 이어집니다.
reason-network who                                             # 누가 있고 그들의 세션이 무엇을 하는지
reason-network send alice/api-claude "did the token format change?"   # alice의 에이전트 하나에게 메시지 보내기
reason-network send alice/api-claude --notify "approve the deploy?"   # 그리고 alice의 화면에 알림으로도 띄우기
reason-network send alice/api-claude --file schema.json "the schema I meant"   # 작은 텍스트 파일과 함께
reason-network send '*' "deploying api at 5"   # 모두에게(또는 alice/*, repo:api): 에이전트가 아니라 내가 보낸 것으로
reason-network listen --as terminal                            # 이 터미널에서 보낸 메시지의 답장 받기
reason-network link                                            # 초대 문장 다시 보기: Join the Reason Network: <link>
reason-network setup                                           # 어떤 에이전트가 연결돼 있고 메시지를 어떻게 처리하는지
reason-network folder ~/personal off                           # ~/personal의 세션은 네트워크에 올리지 않음(on으로 되돌림)

Reason CLI가 있으면 reason network who와 reason network send도 쓸 수 있고, reason network alice/api-claude "…"는 물어본 뒤 답이 올 때까지 기다립니다.

동작 원리

컴퓨터마다 작은 데몬이 돌아갑니다. 팀원들의 컴퓨터는 서로 직접 연결됩니다(같은 Wi-Fi이거나, iroh로 인터넷을 가로질러서). 직접 연결이 안 되면 암호화된 바이트만 보는 릴레이를 거칩니다. 이 릴레이는 Reason이 운영하며, 컴퓨터끼리 서로를 찾는 데는 n0(iroh를 만든 회사)의 주소 조회를 씁니다. 다만 팀이 자체 릴레이(reason-network relay )를 운영하면 컴퓨터는 n0를 포함해 다른 곳과 전혀 통신하지 않습니다. 팀원만 연결할 수 있고, 컴퓨터는 자기 주인을 대신해서만 말할 수 있습니다. 오프라인인 사람에게 보낸 메시지는 대기하다가 그 사람이 돌아오면 전달됩니다.

에이전트 세션의 이름은 에이전트가 식별해 주는 세션이라면 그 대화에 계속 붙어 있습니다. 재시작한 뒤 이어서 열면 같은 이름과 그동안 기다리던 메시지를 돌려받고, 하루 동안은 어떤 새 세션도 그 이름을 가져가지 못합니다. 다시 열린 Codex 세션은 첫 턴에 접속 상태가 됩니다. 그 전에는 Codex가 훅을 실행하지 않기 때문입니다. 최근 하루 안에 확인된 Codex 세션에 온 깨움 메일(FYI 메일 제외)은 codex queue로 스레드에 들어가므로, 세션이 다시 열리면 첫 메시지가 그 턴을 시작합니다. FYI 메일은 그 턴까지 기다립니다.

팀원은 내 이름, 내 컴퓨터, 그리고 내 에이전트 세션이 하고 있는 일(저장소, 브랜치, 바쁜지 한가한지)을 봅니다. Reason으로 로그인했다면 내 이름이 인증된 것으로 표시됩니다. Reason이 그 컴퓨터가 내 것임을 서명하고, 팀원 컴퓨터마다 이를 스스로 검증하며, 다른 누구도 그 이름을 가져갈 수 없습니다. 상태는 ~/.reason/network에 저장됩니다. 자세한 내용은 DESIGN.md에 있습니다.

직접 연결은 데몬이 시작할 때마다 무작위 UDP 포트를 씁니다. 대신 방화벽이나 라우터에서 포트 하나를 열거나 포워딩하려면 ~/.reason/network/config.toml에 지정하세요(컴퓨터마다 설정하며, 데몬이 시작할 때 읽습니다).

port = 41641

port는 [inbound] 같은 [table] 절보다 위, 파일 맨 위에 두세요. 테이블 아래에 적으면 데몬이 무시합니다.

이 포트는 IPv4와 IPv6에 모두 바인딩됩니다(IPv6가 없는 컴퓨터에서는 IPv4만). 어느 쪽에서든 다른 프로그램이 이미 쓰고 있으면 데몬이 그 사실을 기록하고, 설정하지 않았을 때처럼 무작위 포트를 씁니다. port = 0은 설정을 빼 둔 것과 같습니다. reason-network doctor가 사용 중인 포트를 보여 줍니다. 릴레이는 어느 쪽이든 똑같이 동작합니다.

연결이 왜 끊기거나 릴레이로 바뀌는지 알아내려면 debug_log = true(역시 파일 맨 위)로 설정하세요. 데몬이 네트워킹 라이브러리의 이벤트를 ~/.reason/network/debug.log에 기록하며, 이 컴퓨터에만 남고 메시지 본문, 링크, 키는 들어 있지 않습니다. 기본값은 꺼짐입니다. DESIGN.md를 보세요.

제거

reason-network leave && reason-network setup --remove && rm -rf ~/.reason/network ~/.local/bin/reason-network
rm -f ~/.local/bin/tincan   # tincan에서 넘어왔다면

Windows에서는 PowerShell로 이렇게 합니다.

reason-network leave; reason-network setup --remove; Remove-Item -Recurse -Force ~\.reason\network, ~\.local\bin\reason-network*

Reason CLI를 쓴다면 reason network leave를 실행한 뒤 reason network setup --remove를 실행하세요.

빌드

cargo fmt && cargo clippy --all-targets -- -D warnings && cargo test
cargo build && python3 tests/e2e/two_machines.py   # iroh로 컴퓨터 두 대 시험(인터넷 필요)
python3 tests/e2e/hooks.py && python3 tests/e2e/codex_busy.py && python3 tests/e2e/guided.py
python3 tests/e2e/tray_memory.py --output /tmp/tray-memory.json  # macOS 데스크톱, 시험 메뉴는 닫아 둘 것

트레이 메모리 점검은 합성한 로컬 데이터를 쓰고 측정값을 JSON으로 기록합니다. 이와 별개로 시험용 하위 메뉴를 열고 닫은 다음, 몇 번 갱신된 뒤 다시 열어 메뉴가 여전히 동작하는지 확인하세요. 스크립트의 안내를 보세요.

v* 태그를 달면 macOS, Linux, Windows 압축 파일과 설치 스크립트가 초안 릴리스로 빌드되고, 초안을 게시하면 배포됩니다. Reason CLI는 macOS와 Linux 파일을 고정해서 씁니다.

기여하기

이슈와 풀 리퀘스트를 환영합니다. CONTRIBUTING.md를 보세요.

라이선스

MIT OR Apache-2.0(LICENSE-MIT, LICENSE-APACHE). NOTICE를 보세요. 원래는 Reason에서 일하는 Lars Talian이 만든 tincan이었습니다.

스타 히스토리

스타 히스토리 차트

사용량 측정

엔진은 선택적인 집계 사용량 카운터를 별도의 로컬 SQLite 파일에 보관합니다. 보고에는 에이전트 계열, 전달 단계(tier), 훅의 경과 시간, 세션 연결 상태, 대기열 경과 시간의 제한된 스냅샷도 함께 담깁니다. 이 스냅샷에는 대화 ID, 세션 이름, 프로젝트 경로가 들어 있지 않습니다. doctor는 Gemini의 훅 연결을 점검하고, 관찰된 실행 상태를 설치 여부와 따로 보고합니다. 프로젝트 신뢰 여부는 Gemini 자체 화면에서 계속 확인할 수 있습니다.

Reason CLI가 네트워크를 맡고 있으면, 최근 일별 집계를 약 5분마다 제한된 백그라운드 묶음으로 보고합니다. 집계 항목은 에이전트 계열, 로컬 또는 원격 경로, 확인된 계정 관계, 전송 경로, 전달 단계, 연결된 답장, 크기와 지연 시간 구간, 세션 스냅샷, 그리고 보내는 쪽이 붙이는 선택 사항인 용도 라벨(CLI send의 --purpose 옵션)입니다. 엔진 자체는 이 데이터를 업로드하지 않습니다. CLI 없이 단독으로 쓰는 엔진은 카운터를 로컬에만 둡니다.

메시지 본문, 파일, 파일 이름, 저장소, 세션 이름, 메시지 ID, 상대방 신원, 키, 로그인 증명은 이 보고에 들어 있지 않습니다. 기존의 P2P 암호화와 전송 규약은 그대로입니다. Reason 명령을 실행할 때 DO_NOT_TRACK=1을 설정하면 백그라운드 릴레이를 포함해 집계가 로컬에만 남습니다. DO_NOT_TRACK=0으로 설정하면 보고가 다시 켜집니다. 보고는 보고하는 Reason 계정 및 엔진과 연결되므로 익명 데이터가 아니라 사용 메타데이터입니다. 분류할 수 없는 것은 알 수 없음으로 남습니다.

수집은 제한된 비차단 대기열과 전용 데이터베이스 작업자를 씁니다. 분석 쪽 장애가 메시지 전달을 거부하거나 늦추지 않습니다. 집계는 최선을 다한 값입니다. 대기열 넘침, 제한된 차원 용량, 누락된 보고, 오래된 엔진, 저장 전의 충돌 때문에 빈틈이 생길 수 있습니다. 누적 스냅샷은 저장돼 재시작과 재시도 뒤에도 유지되고, 카운터 데이터베이스를 교체하면 새 세대(generation)가 부여됩니다. 수집 한도 때문에 버려진 것도 보고됩니다. 수락은 에이전트가 소비했다는 뜻이 아니며, 답장은 작업이 완료됐다는 증거가 아닙니다. 호스티드 릴레이가 메일을 서버 받은 편지함에 복사한 것은 해당 어시스턴트에게 전달된 것으로 세지 않습니다.


저장소: reason-machines/reason-network