MCP 서버

내 MCP 서버를,
모든 에이전트 CLI에 한 번에

Claude Code는 MCP 서버를 ~/.claude.json에, Codex는 ~/.codex/config.toml에, 다른 CLI도 각자의 파일에 보관합니다. 그중 세 곳에 Notion을 추가하면 같은 서버를 세 번 적고, 로그인도 세 번 해야 합니다. AgentsRoom은 목록을 하나로 관리합니다.

설정 > 에이전트 동작 > MCP 서버에서, 또는 프로젝트나 단일 에이전트에 서버를 선언하세요. AgentsRoom이 실행하는 모든 에이전트가 그 서버를 받으며, 각자의 CLI 형식으로 기록됩니다. Notion, Linear, Atlassian처럼 OAuth로 로그인하는 원격 서버에는 '연결' 버튼이 표시됩니다. 브라우저에서 한 번 로그인하면 그 컴퓨터의 모든 CLI가 서버에 접근합니다.

목록 하나, 모든 CLI
내 MCP 서버
  • notionmcp.notion.com/mcp이 컴퓨터에서 연결됨
  • sentrymcp.sentry.dev/mcp원격
  • githubnpx github-mcp로컬
  • Claude Code
  • Codex
  • GitHub Copilot CLI
  • Cursor
  • 그 밖의 에이전트 CLI 12개

선언은 하나, 실행 시 모든 CLI에 전달됩니다. OAuth 로그인은 컴퓨터마다 한 번이면 모든 CLI에 적용됩니다.

MCP 서버는 코딩 에이전트가 나머지 도구에 닿는 통로입니다. 이슈 트래커, 문서, 오류 모니터링, 데이터베이스 브리지 같은 것들입니다. 모든 에이전트 CLI가 MCP 서버를 지원하지만, 저장 방식은 CLI마다 다르고, 서버를 추가하는 명령도, OAuth로 로그인하는 서버라면 로그인 방식도 저마다 다릅니다.

CLI가 하나라면 문제없습니다. 셋이 되면 새 서버 하나에 세 가지 형식으로 세 번 수정해야 하고, OAuth 서버라면 로그인도 세 번입니다. 그것도 CLI가 OAuth를 지원할 때의 이야기입니다. 목록이 서로 어긋났다는 사실은 보통 다른 CLI의 에이전트가 Linear에 접근할 수 없다고 답하는 날에야 알게 됩니다.

AgentsRoom은 목록을 한 단계 위로 올립니다. 서버는 한 번만 선언합니다. 모든 CLI가 문서화한 mcpServers JSON으로, 또는 공식 MCP 레지스트리의 카탈로그에서요. 실행 시 데스크톱 앱이 에이전트가 실행되는 CLI의 설정에 AgentsRoom 자체 서버와 나란히 기록합니다. MCP 클라이언트가 있는, AgentsRoom이 실행하는 모든 CLI에서 작동합니다. Claude, Codex, GitHub Copilot CLI, Cursor 외 12개 에이전트 CLI입니다. 예외는 Aider로, MCP 클라이언트가 없습니다.

서버 목록 하나로 얻는 것

이미 아는 형식으로 한 번 선언하면, 각 에이전트가 시작할 때 AgentsRoom이 전달합니다.

한 번 선언하면 모든 CLI에 전달

mcpServers 블록 하나, 모든 CLI가 문서화한 형식입니다. 실행 시 AgentsRoom이 이를 Claude Code, Codex, OpenCode, Grok Build, Cursor 등에 맞게 변환하므로 같은 서버를 두 번 적을 일이 없습니다.

세 단계, 가장 좁은 범위가 우선

설정은 모든 프로젝트의 모든 에이전트에, 프로젝트는 그 저장소에, 에이전트는 자기 자신에게 적용됩니다. 서버는 이름 기준으로 병합되며, 에이전트는 상속받은 서버를 다시 선언하지 않고도 끌 수 있습니다.

공식 MCP 레지스트리 내장

'카탈로그에서 추가'는 관리자가 공식 MCP 레지스트리에 게시한 서버를 '검증된 게시자' 표시와 함께 검색하고, 선언을 대신 작성해 줍니다. 원격 주소가 있으면 그것을, 없으면 로컬 패키지를 사용합니다.

'연결' 버튼 하나로 OAuth 로그인

원격 서버가 OAuth 챌린지로 응답하면 그 행에 '이 서버는 OAuth 로그인을 지원합니다.'라고 표시됩니다. 'OAuth 사용', 이어서 '연결'을 누르고 브라우저에서 마치면 행에 '이 컴퓨터에서 연결됨'이 표시됩니다. 토큰은 자동으로 갱신됩니다.

키는 참조로만

주소, 헤더, 환경 변수 값, 인수 어디에든 {{secret:NAME}}를 쓸 수 있습니다. 키는 시크릿 관리자에 보관되고 실행 시 데스크톱 앱에서 해석되며, 선언 안에는 절대 저장되지 않습니다.

재개해도 유지, git에는 들어가지 않음

Claude Code와 GitHub Copilot CLI는 비공개 실행 파일로 서버를 받고, 대화를 재개할 때도 다시 전달됩니다. 다른 CLI의 경우 AgentsRoom이 프로젝트 수준의 설정 파일을 작성하고 git에서 제외합니다.

AgentsRoom 설정, Agent behavior, MCP servers: 모든 CLI의 모든 에이전트에 전달되는 세 서버, notion(Remote, This server offers an OAuth sign-in, Use OAuth), sentry(Remote), github(Local, npx). 각각 스위치와 삭제 버튼이 있고, 그 아래에 Add from catalog와 Paste JSON이 있음
설정 > 에이전트 동작 > MCP 서버: CLI와 상관없이 모든 에이전트가 받는 서버입니다. 프로젝트와 단일 에이전트에도 같은 항목이 있습니다.

서버를 추가하는 방법

다섯 단계, 한 번만. 이후 실행되는 모든 에이전트가 서버를 갖습니다.

  1. 1

    MCP 서버 열기

    설정 > 에이전트 동작의 에이전트 도구에서 MCP 서버를 여세요. AI 제공자의 CLI별 탭에는 없습니다. 서버는 모든 CLI에서 쓰고 싶은 도구이기 때문입니다. 같은 항목이 프로젝트 설정 > AI 제공자와 에이전트 편집기의 고급 옵션에도 있습니다.

  2. 2

    서버 추가하기

    '카탈로그에서 추가'를 누르면 MCP 서버 카탈로그가 열립니다. 검색하고 서버를 골라 '추가'를 누르세요. 또는 'JSON 붙여넣기'를 누르고 CLI에서 이미 쓰는 mcpServers 블록을 mcpServers 래퍼가 있든 없든 그대로 넣으세요. 로컬 서버에는 명령이, 원격 서버에는 url이 필요합니다.

  3. 3

    키는 블록 밖에 두기

    서버에 키가 필요하면 헤더나 환경 변수 값에 {{secret:NAME}}를 적고, 그 이름으로 시크릿 관리자에 키를 저장하세요.

  4. 4

    OAuth 서버 연결하기

    OAuth로 로그인하는 원격 서버라면, 행에 'OAuth 사용'이 표시될 때 누르고 이어서 '연결'을 누르세요. 브라우저에 서비스의 로그인 페이지가 열리고, 승인하면 행에 '이 컴퓨터에서 연결됨'이 표시됩니다.

  5. 5

    에이전트 실행하기

    이후 실행되는 모든 에이전트는 어떤 CLI에서든 AgentsRoom 자체 서버와 나란히 그 서버를 갖습니다. 이미 실행 중인 에이전트는 재시작할 때 새 서버나 새 연결을 받습니다.

Claude Code와 Codex가 이미 스스로 하는 것

Claude Code에는 완전한 자체 MCP 설정 기능이 있습니다. claude mcp add --transport http notion https://mcp.notion.com/mcp 로 원격 서버를 추가하고, local, project, user 스코프에 따라 서버가 ~/.claude.json에 저장될지 git으로 공유되는 .mcp.json에 저장될지가 정해집니다. /mcp는 브라우저에서 OAuth 서버에 로그인시켜 주며, 토큰은 저장되고 자동으로 갱신됩니다(Claude Code 2.1.308, 2026년 10월 22일에 확인한 문서).

Codex CLI에도 있습니다. codex mcp add notion --url https://mcp.notion.com/mcp 는 서버를 ~/.codex/config.toml에 기록하고, codex mcp login notion 은 OAuth 로그인을 실행하며, 브라우저가 없는 머신에서는 --no-browser를 씁니다(codex-cli 0.163.0). 스트리밍 HTTP 서버는 받지만 SSE는 받지 않습니다.

CLI를 하나만 쓴다면 이것으로 충분합니다. AgentsRoom은 이 명령들을 대체하지 않고, 이 명령으로 추가한 서버도 건드리지 않습니다. 그 위에 한 층을 더할 뿐입니다. 모든 CLI를 위한 목록 하나를 실행 시 전달하고, OAuth 서버 로그인은 컴퓨터마다 한 번이면 됩니다. 이는 오픈 소스 브리지 mcp-remote를 통해 이루어지며, 각 CLI의 자체 OAuth 지원과 관계없이 모든 CLI에서 똑같이 작동합니다.

제한 사항

  • OAuth 서버를 연결하려면 컴퓨터에 Node.js가 있어야 합니다. 로그인이 npx를 통해 실행되기 때문입니다. Node.js가 없으면 '연결'이 이 컴퓨터에서 npx를 찾을 수 없다고 알려 줍니다.
  • OAuth 연결은 컴퓨터에 속합니다. 다른 머신에서는 다시 로그인해야 하며, '연결 해제'는 이 컴퓨터에서만 연결을 지웁니다. 설정의 목록도 마찬가지입니다. 프로젝트에 선언한 서버는 프로젝트를 따라 다른 컴퓨터로도 이어집니다.
  • 이미 실행 중인 에이전트는 재시작해야 새 서버나 새 연결을 인식합니다.
  • Aider에는 MCP 클라이언트가 없어 서버를 받지 않습니다. Codex와 Mistral Vibe에는 SSE 전송 방식이 없습니다. 일반 SSE 서버는 이 둘에서 건너뛰고, HTTP는 작동하며, OAuth 서버는 로컬 브리지를 통해 어쨌든 이 둘에 닿습니다.
  • Windows에서는 주소나 헤더에 & 나 % 처럼 cmd.exe가 특수 문자로 읽는 문자가 들어 있는 OAuth 서버를 시작할 수 없습니다. 그 서버는 건너뛰며, '연결'이 이를 알려 줍니다.
  • 각 에이전트는 사용하는 OAuth 서버마다 자체 브리지 프로세스를 시작합니다.
  • 휴대폰에는 MCP 서버 편집기가 없습니다. 휴대폰에서 시작한 에이전트는 데스크톱 앱이 같은 서버로 실행하며, 그 컴퓨터에서 맺은 연결을 사용합니다.

자주 묻는 질문

같은 MCP 서버를 Claude Code와 Codex에 추가하려면 어떻게 하나요?

AgentsRoom의 설정 > 에이전트 동작 > MCP 서버에서 한 번만 선언하세요. 어떤 CLI에든 붙여넣을 mcpServers JSON을 쓰거나 카탈로그에서 고르면 됩니다. 그러면 AgentsRoom이 실행하는 모든 에이전트가 Claude Code와 Codex를 포함해 각자의 CLI 형식으로 서버를 받습니다. AgentsRoom 없이는 두 번 추가해야 합니다. Claude Code에는 claude mcp add, Codex에는 codex mcp add입니다.

OAuth를 쓰는 MCP 서버에는 어떻게 로그인하나요?

Claude Code에서는 /mcp를 실행하고 브라우저에서 로그인을 진행합니다. Codex CLI에서는 서버 이름과 함께 codex mcp login을 실행합니다. AgentsRoom에서는 서버가 OAuth 챌린지로 응답하면 서버 행에 'OAuth 사용'이 표시됩니다. '연결'을 누르고 브라우저에서 마치면, 그 컴퓨터에 있는 모든 CLI의 모든 에이전트가 서버에 접근하며 토큰은 자동으로 갱신됩니다.

OAuth를 지원하지 않는 CLI에서도 OAuth 연결이 작동하나요?

네. OAuth 서버는 모든 CLI에 같은 로컬 명령, 즉 오픈 소스 브리지 mcp-remote로 전달됩니다. 이 브리지가 로그인을 처리하고 토큰을 갱신합니다. 연결은 MCP 클라이언트가 있는 모든 CLI에서 똑같이 작동하며, SSE 서버도 이 방식으로 Codex와 Mistral Vibe에 닿습니다. 두 CLI 모두 자체 SSE 전송 방식이 없는데도 말입니다.

어떤 서버를 OAuth로 연결할 수 있나요?

OAuth로 로그인하는 원격 MCP 서버라면 무엇이든 됩니다. Notion, Linear, Atlassian, Buddy.Works 등입니다. AgentsRoom은 헤더가 없는 원격 서버를 확인하고, OAuth 챌린지로 응답하면 그 행에 '이 서버는 OAuth 로그인을 지원합니다.'라고 표시합니다.

MCP 서버에 필요한 API 키는 어디에 보관하나요?

시크릿 관리자에 보관합니다. 키가 필요한 헤더, 주소, 환경 변수 값, 인수에 {{secret:NAME}}를 적고, 그 이름으로 키를 저장하세요. 값은 실행 시 데스크톱 앱에서 해석되며 선언 안에는 절대 저장되지 않습니다.

한 에이전트에서만 서버를 끌 수 있나요?

네. 에이전트 편집기의 고급 옵션 > MCP 서버에서 상속된 행을 끄세요. 에이전트에는 그 서버가 비활성화되었다는 사실만 담은 재정의가 저장되고, 다른 에이전트는 계속 그 서버를 사용합니다.

claude mcp add로 추가한 서버가 Claude Code 에이전트에 보이지 않습니다. 왜 그런가요?

AgentsRoom 계정 프로필에서는 Claude Code가 기본적으로 개인 설정을 읽지 않습니다. 설정 > 다중 계정에서 '내 개인 CLI 설정 사용'을 켜거나, AgentsRoom의 MCP 서버에 서버를 선언하세요. 이쪽은 모든 계정과 모든 CLI에 닿습니다.

다른 컴퓨터에서도 MCP 서버가 같나요?

프로젝트에 선언한 서버는 프로젝트를 따라 다른 컴퓨터로 이어집니다. 설정의 목록과 OAuth 연결은 컴퓨터에 속하므로 머신마다 한 번씩 선언하고 연결합니다. 휴대폰에는 편집기가 없습니다. 휴대폰에서 시작한 에이전트는 그것을 실행하는 컴퓨터의 서버와 연결을 사용합니다.

이런 기능도 있습니다

MCP : 에이전트 조종 가능 : 수동 또는 자동

MCP 서버 4개로 Claude Code, Codex를 비롯한 CLI가 AgentsRoom 자체를 조종합니다. 백로그를 읽고, dev 명령을 실행하고, 프롬프트 라이브러리를 쓰고, 내장 브라우저를 조작합니다.

시크릿 관리자

API 키, 토큰, 비밀번호를 OS 키체인에 저장하고, 개발 명령과 에이전트 환경에서 {ref}로 참조하면 AgentsRoom이 실행 시점에 실제 값을 채웁니다. 에이전트는 이름만 볼 뿐 값은 보지 못하며, 서버로 동기화되는 것은 아무것도 없습니다.

멀티 프로바이더

AgentsRoom은 17개 AI 코딩 프로바이더를 지원합니다: Claude, Codex, GitHub Copilot CLI, OpenCode, Antigravity CLI, Aider, Grok Build, Mistral Vibe, Kimi Code, Amp, oh-my-pi, Freebuff, Devin, Cursor, Command Code, Muse Code, Pi. 에이전트별로 다른 프로바이더를 할당하고, 대화 중 프로바이더를 전환하며, 자동 핸드오프로 컨텍스트를 유지합니다. 최고의 멀티 프로바이더 AI 코딩 도구.

Claude 멀티 계정

컴퓨터 한 대에서 Claude Code 계정 두 개 이상을 AgentsRoom 안에서 나란히 실행하세요. 한 프로젝트에는 개인 계정, 다른 프로젝트에는 업무 계정, 또 다른 프로젝트에는 고객사 계정을 쓰세요. 프로젝트별 계정 고정, 에이전트별 재정의, 앱 내 로그인. macOS, Windows, Linux에서 무료로 다운로드하세요.

네트워크 프록시

Claude Code, Codex와 모든 에이전트 CLI에 각기 다른 HTTP 또는 SOCKS 프록시를 설정하세요. AgentsRoom은 프로바이더별로 HTTPS_PROXY를 설정하고, 실행 전에 출구 IP를 보여 주며, 비밀번호를 평문으로 남기지 않습니다.

모든 에이전트를 위한 하나의 MCP 서버 목록

AgentsRoom을 다운로드하고 서버를 한 번만 선언해 Claude Code, Codex, 모든 에이전트 CLI에 전달하세요.

무료AgentsRoom 다운로드

컴패니언 앱: 이동 중에도 에이전트를 모니터링

Claude, Codex, Antigravity CLI 또는 다른 AI 공급자를 사용하세요.

확장 프로그램 설치
Chrome Web Store

버그와 요청을 공개 백로그로 바로 보내세요.

멀티 프로젝트
멀티 프로바이더
멀티 에이전트
실시간 상태
파일 diff & 커밋
모바일 앱
라이브 프리뷰
에이전트 팀
브라우저 자동화
백로그 기반 개발
프롬프트 라이브러리
스킬 라이브러리
모든 기능 보기