---
title: "Thêm máy chủ MCP vào Claude Code và Codex"
description: "Chạy claude mcp add --transport http trong Claude Code hoặc codex mcp add --url trong Codex, rồi đăng nhập. Chúng tôi đã thử cả 2 với máy chủ MCP của LogBrew."
canonical: "https://logbrew.co/vi/guides/mcp-server-claude-code-codex"
last_updated: "2026-11-10"
---

# Thêm máy chủ MCP vào Claude Code và Codex

Chạy `claude mcp add --transport http` trong Claude Code hoặc `codex mcp add --url` trong Codex, rồi đăng nhập. Chúng tôi đã thử cả 2 với máy chủ MCP của LogBrew.

Đã thử nghiệm ngày 10 tháng 11, 2026 với Claude Code 2.1.319 và Codex CLI 0.167.0

Tác giả [Furkan Erday](https://github.com/furkanerday). Furkan Erday là nhà sáng lập LogBrew. Anh xây dựng LogBrew bằng Claude Code và Codex mỗi ngày.

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

## 1 máy chủ MCP, 2 agent

Máy chủ MCP của LogBrew `https://logbrew.co/mcp`

Công cụ `search` `execute`

|  | Claude Code | Codex |
| --- | --- | --- |
|  | `claude mcp add --transport http` | `codex mcp add --url` |
| Lưu tại | `~/.claude.json` | `~/.codex/config.toml` |
| Trước khi đăng nhập | `Needs authentication` | `Not logged in` |

## Claude Code

### Thêm máy chủ

Chạy lệnh này trong thư mục dự án. Claude Code chỉ thêm máy chủ cho dự án này và lưu nó vào `~/.claude.json`.

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

Kết quả

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

### Chia sẻ hoặc dùng ở mọi dự án

`--scope project` ghi file `.mcp.json` ở thư mục gốc của dự án, nên cả nhóm nhận được máy chủ qua Git. `--scope user` thêm máy chủ vào mọi dự án của bạn.

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

Kết quả

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

### Kiểm tra máy chủ

Claude Code kiểm tra từng máy chủ mà nó liệt kê. Trước khi bạn đăng nhập, máy chủ dùng OAuth hiện `Needs authentication`. Máy chủ từ `.mcp.json` hiện `Pending approval` cho đến khi bạn phê duyệt nó trong một phiên.

```bash
claude mcp list
```

Kết quả

```text
Checking MCP server health…

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

### Đăng nhập

Gõ `/mcp` trong một phiên, chọn máy chủ và cấp quyền truy cập trong trình duyệt. Từ shell, lệnh `claude mcp login logbrew` làm việc tương tự. Thêm `--no-browser` khi làm việc qua SSH.

```bash
/mcp
```

## Codex

### Thêm máy chủ

Codex ghi bảng `[mcp_servers.logbrew]` vào `~/.codex/config.toml`. Nếu máy chủ dùng OAuth, Codex bắt đầu đăng nhập ngay và mở trình duyệt.

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

Kết quả

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

### Đăng nhập sau hoặc qua SSH

Nếu bạn lỡ đóng tab trình duyệt, hãy đăng nhập sau bằng lệnh này. Qua SSH, thêm `--no-browser`, mở URL được in ra trên một máy tính khác, rồi dán toàn bộ URL chuyển hướng vào lại terminal.

```bash
codex mcp login logbrew
```

### Kiểm tra máy chủ

Trước khi bạn đăng nhập, cột `Auth` hiện `Not logged in`. Gõ `/mcp` trong một phiên Codex đang mở để xem các máy chủ đang hoạt động của bạn.

```bash
codex mcp list
```

Kết quả

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

## Kết quả khi chúng tôi thử nghiệm

Chúng tôi chạy mọi lệnh trên trang này trên macOS, với các thư mục cấu hình tạm do `CLAUDE_CONFIG_DIR` và `CODEX_HOME` chỉ định, nên không thiết lập thật nào bị thay đổi.

Trong Claude Code, mỗi lệnh `claude mcp add` in ra file mà nó đã thay đổi. Sau đó `claude mcp list` hiện `Needs authentication` cho máy chủ mới và `Pending approval` cho máy chủ trong `.mcp.json`.

Trong Codex, `codex mcp add` in ra `Detected OAuth support. Starting OAuth flow…` rồi in một URL đăng nhập. Chúng tôi đã chặn trình duyệt khi thử nghiệm, nên Codex yêu cầu chúng tôi tự sao chép URL. Bạn sẽ thấy một tab trình duyệt mở ra khi thêm máy chủ dùng OAuth.

Ở cả 2 agent, chúng tôi dừng trước màn hình cấp quyền. Các bước đăng nhập trên trang này làm theo tài liệu của Claude Code và Codex.

## Sửa lỗi invalid transport trong mcp_servers

Codex dừng với lỗi `invalid transport` trong `mcp_servers.logbrew` khi một bảng máy chủ không có `url` cũng không có `command`. Chúng tôi gặp đúng lỗi này với một bảng `[mcp_servers.logbrew]` trống.

Mỗi bảng cần 1 trong 2 khóa này. Dùng `url` cho máy chủ từ xa và `command` cho máy chủ cục bộ. Bảng có cả 2 khóa cũng lỗi, với thông báo `url is not supported for stdio`. Dòng `type = "http"` kiểu Claude không gây hại gì, vì Codex bỏ qua nó.

Báo cáo #40715 cho thấy cùng thông báo này trong ứng dụng ChatGPT desktop trên Windows, với mục `mcp_servers.codex_app` mà người dùng chưa từng viết. Ngày 26 tháng 8 năm 2026, một kỹ sư OpenAI viết rằng nhóm đang sửa lỗi này. Báo cáo vẫn đang mở.

Kết quả

```text
Error: failed to load bootstrap configuration

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

## Giới hạn công cụ và thời gian chờ trong Codex

`enabled_tools` chỉ giữ các công cụ bạn liệt kê, sau đó `disabled_tools` loại bỏ bớt công cụ. `startup_timeout_sec` và `tool_timeout_sec` mặc định là 10 và 60 giây. Máy chủ LogBrew có 2 công cụ, `search` và `execute`. `codex mcp get logbrew` hiện đúng từng giá trị chúng tôi đặt.

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

## Sửa cấu hình Claude Code bằng tay

Đây là file `.mcp.json` mà `--scope project` đã ghi trong lần thử của chúng tôi. Claude Code yêu cầu từng người phê duyệt máy chủ ở lần đầu nó khởi động trong dự án đó.

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

## Câu hỏi thường gặp

### Claude Code có hỗ trợ máy chủ MCP từ xa không?

Có. Dùng `--transport http` với URL của máy chủ. Khi máy chủ dùng OAuth, Claude Code cho bạn đăng nhập qua `/mcp` hoặc `claude mcp login`.

### Claude Code lưu máy chủ MCP ở đâu?

Máy chủ cục bộ và máy chủ cấp người dùng nằm trong `~/.claude.json`. Máy chủ cấp dự án nằm trong `.mcp.json` ở thư mục gốc của dự án.

### Codex lưu máy chủ MCP ở đâu?

Trong `~/.codex/config.toml`, hoặc trong `.codex/config.toml` với dự án bạn tin cậy.

### Làm sao để gỡ một máy chủ MCP?

Chạy `claude mcp remove logbrew` hoặc `codex mcp remove logbrew`. Trong Claude Code, nếu bạn cũng muốn thu hồi token, hãy chạy `claude mcp logout logbrew` trước.

## Cho agent đọc lỗi trên production

Máy chủ MCP của LogBrew cung cấp cho Claude Code, Codex và mọi MCP client khác lỗi, log và trace của các dự án bạn phê duyệt. Máy chủ chỉ đọc, trừ khi bạn cấp thêm quyền. Bắt đầu với gói miễn phí rộng rãi, không cần thẻ.

[Kết nối agent](https://logbrew.co/vi/agents)

## Nguồn

- [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)

## Thêm hướng dẫn cho AI agent lập trình

- [Dùng AGENTS.md trong Claude Code và Codex](https://logbrew.co/vi/guides/agents-md)
- [Khắc phục lỗi Claude overloaded 529 và lỗi rate limit 429](https://logbrew.co/vi/guides/claude-overloaded-rate-limit-error)
- [Cách sửa lỗi trong Claude Code, Codex và JavaScript trên trình duyệt](https://logbrew.co/vi/guides)