/ 디렉터리 / 플레이그라운드 / 1MCP Agent
← 모든 서버 ↗ GitHub
● 커뮤니티 1mcp-app ⚡ 바로 사용

1MCP Agent

제작: 1mcp-app · 1mcp-app/agent

사용 중인 모든 MCP 서버를 하나의 엔드포인트로 통합 — 공유 설정, 공유 인증, 네임스페이스 도구 이름, 한 곳에서 모두 업데이트.

1mcp/agent는 MCP 서버를 위한 통합 프록시입니다. 모든 서버(filesystem, github, postgres, sentry 등)를 한 번만 설정하면 클라이언트(Claude Desktop / Cursor / Cline)는 MCP 하나만 봅니다. 도구 이름에 접두사가 붙고(github__create_issue), 에이전트가 생성/상태 확인을 처리하며, 클라이언트 재시작 없이 설정을 실시간 반영할 수 있습니다.

▶ 데모 보기 📦 설치 💡 사용 사례

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

onemcp-agent.replay ▶ 준비됨
0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "onemcp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "onemcp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "onemcp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "onemcp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "onemcp-agent",
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json
{
  "context_servers": {
    "onemcp-agent": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@1mcp/agent"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add onemcp-agent -- npx -y @1mcp/agent

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: 1MCP Agent

20개 이상의 MCP 서버를 하나의 엔드포인트로 통합

👤 많은 MCP가 설정된 파워 유저 ⏱ ~25 min intermediate

언제 쓸까: claude_desktop_config.json에 20개 이상의 항목이 있고 서버 추가/제거가 불편할 때.

사전 조건
  • 1mcp 설치 — npx -y @1mcp/agent (또는 문서에 따라 영구 설치)
흐름
  1. 기존 서버를 1mcp 설정으로 이전
    Use onemcp-agent. Convert my current MCP client config into a 1mcp config file with each server prefixed by its name.✓ 복사됨
    → 모든 서버와 접두사가 있는 1mcp.config.json
  2. 클라이언트를 1mcp로 연결
    Replace my client's MCP config with a single entry pointing at 1mcp; keep a backup.✓ 복사됨
    → 클라이언트가 서버 하나를 봄; 접두사가 있는 도구 목록
  3. 새 서버 실시간 추가
    Add the new arxiv MCP to 1mcp config and reload — without restarting Claude Desktop.✓ 복사됨
    → 다음 list_tools 갱신에서 새 도구 표시

결과: 모든 MCP 서버의 단일 진실 소스; 더 빠른 반복.

함정
  • 접두사로 도구 이름이 길어짐 — 서버별로 짧은 접두사 별칭 사용 (gh, fs, pg)

개발 박스에서 팀 공유 MCP 스택 운영

👤 공유 인프라를 사용하는 소규모 개발 팀 ⏱ ~45 min advanced

언제 쓸까: 팀 전체가 설정을 중복하지 않고 동일한 검증된 MCP 서버와 비밀 키를 공유하길 원할 때.

사전 조건
  • 접근 가능한 호스트 — 인증을 통해 SSE/HTTP transport를 노출하는 개발 박스에서 1mcp 실행
흐름
  1. 설정 중앙화
    Configure 1mcp on the dev box with our team's MCP set + shared auth tokens. Expose via authenticated SSE.✓ 복사됨
    → 스택 실행 중; SSE 엔드포인트에 bearer token 필요
  2. 단일 클라이언트 설정 배포
    Generate per-developer client snippets pointing to the shared SSE URL with their personal bearer.✓ 복사됨
    → 개발자당 하나의 스니펫

결과: 팀원들이 20개의 설정을 각자 관리하지 않고도 검증된 MCP 환경을 사용.

함정
  • 단일 호스트 = 단일 장애점 — 로컬 설정으로의 폴백 문서화; 또는 로드 밸런서 뒤에 복제본 운영

신뢰할 수 없는 MCP를 1mcp 뒤에서 격리

👤 커뮤니티 MCP를 시험해보는 보안 의식 있는 사용자 ⏱ ~30 min advanced

언제 쓸까: 서드파티 MCP를 사용해보고 싶지만 전체 환경이나 파일시스템 접근을 주고 싶지 않을 때.

흐름
  1. 컨테이너에서 1mcp 실행
    Set up 1mcp in a Docker container with minimal env; mount only ./scratch/. Add the untrusted MCP under a 'sandbox' prefix.✓ 복사됨
    → 컨테이너 실행 중; sandbox MCP에서 sandbox/ 도구만 표시
  2. 하나의 작업에만 사용
    Run the experimental task only with sandbox__ tools.✓ 복사됨
    → 작업 완료; 아무것도 컨테이너를 벗어나지 않음

결과: 중요한 모든 것에 접근 권한을 주지 않고 신뢰할 수 없는 서버 시험.

함정
  • 컨테이너 내부에서도 MCP가 네트워크에 접근할 수 있다는 것을 잊음 — 외부 통신이 중요하다면 --network none 또는 제한된 네트워크 네임스페이스 사용

조합

다른 MCP와 조합해 10배 효율

onemcp-agent + filesystem + github

일상 사용 서버 세트의 통합기

Configure 1mcp with filesystem (prefix fs) + github (prefix gh) + postgres (prefix pg). Use fs__read_file and gh__create_issue from one client.✓ 복사됨

도구

이 MCP가 노출하는 것

도구입력언제 호출비용
list_servers — 상태 확인 / 디버그 0
reload_config config_path? 1mcp.config.json 편집 후 0
restart_server server_name 자식 서버가 오작동할 때 0
<prefix>__<tool> as per child tool 모든 자식 도구는 접두사와 함께 표시됨 depends on child server

비용 및 제한

운영 비용

API 쿼터
호출당 무시할 수 있는 오버헤드 추가
호출당 토큰
0 — 프록시가 통과; 도구 목록 비용은 자식의 합계
금액
무료
팁
거의 사용하지 않는 자식 서버는 제거 대신 설정 플래그로 비활성화 — prompt를 슬림하게 유지

보안

권한, 시크릿, 파급범위

최소 스코프: Whatever child servers need
자격 증명 저장: 자식 서버 환경 변수가 1mcp.config.json에 집중됨 — 이 파일을 보호
데이터 외부 송신: 자식 서버가 하는 모든 것 — 1mcp 자체는 원격 SSE로 설정하지 않으면 외부 통신 없음
절대 부여 금지: 비밀 키가 있는 설정 파일의 전체 읽기 권한

문제 해결

자주 발생하는 오류와 해결

자식 서버 시작 실패

해당 서버의 stderr에 대한 1mcp 로그 확인; 보통 환경 변수 누락이나 잘못된 명령 경로

확인: Try the child's command standalone in a terminal
도구 이름 충돌

설정에서 서버별 접두사 추가 또는 단축

확인: list_servers shows current prefixes
실시간 반영이 변경 사항을 인식하지 못함

일부 변경(transport 모드, 포트)은 재시작 필요. 영향받는 자식 또는 전체 1mcp에서 restart_server 실행

첫 응답이 느림

자식이 기본적으로 지연 생성됨 — 자주 사용하는 서버에 'eager: true' 설정

대안

1MCP Agent 다른 것과 비교

대안언제 쓰나단점/장점
metamcp팀 워크플로우가 있는 UI 관리 통합기를 원할 때더 무거움; 더 강한 의견
mcp-router (TheLunarCompany/lunar)거버넌스와 감사 로그가 필요할 때 (엔터프라이즈)더 넓은 범위; 더 많은 설정

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기