---
title: "Claude Code와 Codex에 MCP 서버 추가하기"
description: "Claude Code에서는 claude mcp add --transport http, Codex에서는 codex mcp add --url을 실행한 뒤 로그인하세요. LogBrew MCP 서버로 둘 다 테스트했어요."
canonical: "https://logbrew.co/ko/guides/mcp-server-claude-code-codex"
last_updated: "2026-11-10"
---

# Claude Code와 Codex에 MCP 서버 추가하기

Claude Code에서는 `claude mcp add --transport http`, Codex에서는 `codex mcp add --url`을 실행한 뒤 로그인하세요. LogBrew MCP 서버로 둘 다 테스트했어요.

Claude Code 2.1.319 및 Codex CLI 0.167.0 환경에서 2026년 11월 10일에 테스트

글 [Furkan Erday](https://github.com/furkanerday). LogBrew 창업자 Furkan Erday. 매일 Claude Code와 Codex로 LogBrew를 만들어요.

Canonical: https://logbrew.co/ko/guides/mcp-server-claude-code-codex

## MCP 서버 1개, 에이전트 2개

LogBrew MCP 서버 `https://logbrew.co/mcp`

도구 `search` `execute`

|  | Claude Code | Codex |
| --- | --- | --- |
|  | `claude mcp add --transport http` | `codex mcp add --url` |
| 저장 위치 | `~/.claude.json` | `~/.codex/config.toml` |
| 로그인 전 | `Needs authentication` | `Not logged in` |

## Claude Code

### 서버 추가

프로젝트 폴더에서 실행하세요. Claude Code는 이 프로젝트에만 서버를 추가하고 `~/.claude.json`에 저장해요.

```bash
claude mcp add --transport http logbrew https://logbrew.co/mcp
```

출력

```text
Added HTTP MCP server logbrew with URL: https://logbrew.co/mcp to local config
```

### 팀과 공유하거나 모든 프로젝트에서 쓰기

`--scope project`는 프로젝트 루트에 `.mcp.json`을 만들어요. 그래서 팀원도 Git으로 같은 서버를 받아요. `--scope user`는 내 모든 프로젝트에 서버를 추가해요.

```bash
claude mcp add --transport http logbrew --scope user https://logbrew.co/mcp
```

출력

```text
Added HTTP MCP server logbrew with URL: https://logbrew.co/mcp to user config
```

### 서버 확인

Claude Code는 목록에 있는 서버를 하나씩 확인해요. OAuth를 쓰는 서버는 로그인 전에 `Needs authentication`으로 표시돼요. `.mcp.json`에서 온 서버는 세션에서 승인하기 전까지 `Pending approval`로 표시돼요.

```bash
claude mcp list
```

출력

```text
Checking MCP server health…

logbrew: https://logbrew.co/mcp (HTTP) - ! Needs authentication
```

### 로그인

세션에서 `/mcp`를 입력하고 서버를 고른 뒤 브라우저에서 접근을 승인하세요. 셸에서는 `claude mcp login logbrew`로 같은 작업을 할 수 있어요. SSH로 접속했다면 `--no-browser`를 붙이세요.

```bash
/mcp
```

## Codex

### 서버 추가

Codex는 `~/.codex/config.toml`에 `[mcp_servers.logbrew]` 테이블을 써요. 서버가 OAuth를 쓰면 Codex가 바로 로그인을 시작하고 브라우저를 열어요.

```bash
codex mcp add logbrew --url https://logbrew.co/mcp
```

출력

```text
Added global MCP server 'logbrew'.
Detected OAuth support. Starting OAuth flow…
```

### 나중에 로그인하거나 SSH에서 로그인

브라우저 탭을 닫았다면 이 명령으로 나중에 로그인하세요. SSH에서는 `--no-browser`를 붙이고, 출력된 URL을 다른 컴퓨터에서 연 다음, 리디렉션 URL 전체를 터미널에 붙여 넣으세요.

```bash
codex mcp login logbrew
```

### 서버 확인

로그인 전에는 `Auth` 열에 `Not logged in`이 표시돼요. 열린 Codex 세션에서 `/mcp`를 입력하면 활성 서버를 볼 수 있어요.

```bash
codex mcp list
```

출력

```text
Name     Url                     Bearer Token Env Var  Status   Auth
logbrew  https://logbrew.co/mcp  -                     enabled  Not logged in
```

## 직접 테스트해 보니

이 페이지의 모든 명령을 macOS에서 실행했어요. `CLAUDE_CONFIG_DIR`와 `CODEX_HOME`으로 임시 설정 폴더를 지정해서 실제 설정은 바뀌지 않았어요.

Claude Code에서는 `claude mcp add`를 실행할 때마다 변경한 파일이 출력됐어요. 이어서 `claude mcp list`를 실행하니 새 서버는 `Needs authentication`, `.mcp.json`에 있는 서버는 `Pending approval`로 나왔어요.

Codex에서는 `codex mcp add`가 `Detected OAuth support. Starting OAuth flow…`를 출력하고 이어서 로그인 URL을 출력했어요. 테스트에서는 브라우저를 막아 뒀기 때문에 Codex가 URL을 직접 복사하라고 안내했어요. OAuth를 쓰는 서버를 추가하면 브라우저 탭이 열린다고 생각하세요.

두 에이전트 모두 동의 화면 앞에서 멈췄어요. 이 페이지의 로그인 단계는 Claude Code와 Codex 문서를 따라요.

## mcp_servers의 invalid transport 오류 해결

서버 테이블에 `url`과 `command`가 둘 다 없으면 Codex는 `mcp_servers.logbrew`에서 `invalid transport` 오류를 내고 멈춰요. 빈 `[mcp_servers.logbrew]` 테이블로 이 오류를 그대로 재현했어요.

테이블마다 2개 중 1개만 넣으세요. 원격 서버에는 `url`, 로컬 서버에는 `command`를 쓰세요. 둘 다 넣어도 `url is not supported for stdio` 오류로 실패해요. Claude 방식의 `type = "http"` 줄은 Codex가 무시하니 그대로 둬도 괜찮아요.

제보 #40715에서는 Windows용 ChatGPT 데스크톱 앱에서 사용자가 쓴 적 없는 `mcp_servers.codex_app` 항목 때문에 같은 메시지가 나와요. 2026년 8월 26일, OpenAI 엔지니어가 팀이 수정 작업 중이라고 적었어요. 이 제보는 아직 열려 있어요.

출력

```text
Error: failed to load bootstrap configuration

Caused by:
    invalid transport
    in `mcp_servers.logbrew`
```

## Codex에서 도구와 대기 시간 제한하기

`enabled_tools`는 목록에 적은 도구만 남기고, `disabled_tools`는 그다음에 도구를 빼요. `startup_timeout_sec`와 `tool_timeout_sec`의 기본값은 각각 10초와 60초예요. LogBrew 서버에는 `search`와 `execute`, 이렇게 2개의 도구가 있어요. `codex mcp get logbrew`로 설정한 값을 모두 확인할 수 있었어요.

```bash
[mcp_servers.logbrew]
url = "https://logbrew.co/mcp"
enabled_tools = ["search", "execute"]
startup_timeout_sec = 20
```

## Claude Code 설정 직접 편집하기

테스트에서 `--scope project`가 만든 `.mcp.json`이에요. 그 프로젝트에서 Claude Code를 처음 시작하면 사람마다 서버를 승인할지 물어봐요.

```bash
{
  "mcpServers": {
    "logbrew": {
      "type": "http",
      "url": "https://logbrew.co/mcp"
    }
  }
}
```

## 자주 묻는 질문

### Claude Code에서 원격 MCP 서버를 쓸 수 있나요?

네. 서버 URL과 함께 `--transport http`를 쓰세요. 서버가 OAuth를 쓰면 Claude Code가 `/mcp`나 `claude mcp login`으로 로그인을 진행해요.

### Claude Code는 MCP 서버를 어디에 저장하나요?

로컬 서버와 사용자 서버는 `~/.claude.json`에 저장돼요. 프로젝트 서버는 프로젝트 루트의 `.mcp.json`에 저장돼요.

### Codex는 MCP 서버를 어디에 저장하나요?

`~/.codex/config.toml`에 저장돼요. 신뢰하는 프로젝트라면 `.codex/config.toml`에 둘 수도 있어요.

### MCP 서버는 어떻게 삭제하나요?

`claude mcp remove logbrew` 또는 `codex mcp remove logbrew`를 실행하세요. Claude Code에서 토큰도 폐기하려면 먼저 `claude mcp logout logbrew`를 실행하세요.

## 에이전트가 프로덕션 오류를 직접 읽게 하세요

LogBrew MCP 서버는 Claude Code, Codex 등 모든 MCP 클라이언트에 승인한 프로젝트의 오류, 로그, 트레이스를 제공해요. 권한을 더 주지 않는 한 읽기만 해요. 넉넉한 무료 요금제로 시작하세요. 카드 등록은 필요 없어요.

[에이전트 연결하기](https://logbrew.co/ko/agents)

## 출처

- [Claude Code docs, Connect Claude Code to tools via MCP](https://code.claude.com/docs/en/mcp)
- [Codex docs, Model Context Protocol](https://learn.chatgpt.com/docs/extend/mcp?surface=cli)
- [openai/codex#40715](https://github.com/openai/codex/issues/40715)

## AI 코딩 에이전트 가이드 더 보기

- [Claude Code와 Codex에서 AGENTS.md 쓰기](https://logbrew.co/ko/guides/agents-md)
- [Claude overloaded 529 오류와 rate limit 429 오류 해결하기](https://logbrew.co/ko/guides/claude-overloaded-rate-limit-error)
- [Claude Code, Codex, 브라우저 JavaScript 오류 해결법](https://logbrew.co/ko/guides)