---
title: "أضف خادم MCP إلى Claude Code وCodex"
description: "شغّل claude mcp add --transport http في Claude Code أو codex mcp add --url في Codex، ثم سجّل الدخول. اختبرنا الطريقتين مع خادم MCP من LogBrew."
canonical: "https://logbrew.co/ar/guides/mcp-server-claude-code-codex"
last_updated: "2026-11-10"
---

# أضف خادم MCP إلى Claude Code وCodex

شغّل `claude mcp add --transport http` في Claude Code أو `codex mcp add --url` في Codex، ثم سجّل الدخول. اختبرنا الطريقتين مع خادم MCP من LogBrew.

اختُبر في 10 نوفمبر 2026 باستخدام Claude Code 2.1.319 وCodex CLI 0.167.0

بقلم [Furkan Erday](https://github.com/furkanerday). Furkan Erday مؤسس LogBrew، ويبني LogBrew كل يوم باستخدام Claude Code وCodex.

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

## خادم MCP واحد ووكيلان

خادم MCP من LogBrew `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` الشيء نفسه. أضف `--no-browser` عند العمل عبر SSH.

```bash
/mcp
```

## Codex

### أضف الخادم

يكتب Codex جدول `[mcp_servers.logbrew]` في `~/.codex/config.toml`. وإذا كان الخادم يستخدم 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` وافتح الرابط المطبوع على جهاز آخر، ثم الصق رابط إعادة التوجيه كاملًا في الطرفية.

```bash
codex mcp login logbrew
```

### تحقّق من الخادم

قبل تسجيل الدخول، يعرض العمود `Auth` القيمة `Not logged in`. اكتب `/mcp` في جلسة Codex مفتوحة لترى خوادمك النشطة.

```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` للخادم الجديد والحالة `Pending approval` للخادم الموجود في `.mcp.json`.

في Codex، طبع `codex mcp add` الرسالة `Detected OAuth support. Starting OAuth flow…` ثم رابط تسجيل الدخول. كنا قد حظرنا المتصفح في الاختبار، فطلب منا Codex نسخ الرابط يدويًا. توقّع فتح تبويب في المتصفح عند إضافة خادم يستخدم OAuth.

توقّفنا قبل شاشة الموافقة في الوكيلين. وخطوات تسجيل الدخول في هذه الصفحة تتبع مستندات Claude Code وCodex.

## إصلاح خطأ invalid transport في mcp_servers

يتوقف Codex مع الخطأ `invalid transport` في `mcp_servers.logbrew` عندما لا يحتوي جدول الخادم على `url` ولا على `command`. ظهر لنا هذا الخطأ نفسه من جدول `[mcp_servers.logbrew]` فارغ.

ضع في كل جدول 1 فقط من المفتاحين. استخدم `url` للخادم البعيد و`command` للخادم المحلي. والجدول الذي يحتوي على الاثنين يفشل أيضًا مع `url is not supported for stdio`. أما سطر `type = "http"` بأسلوب Claude فلا يضر، لأن Codex يتجاهله.

يُظهر البلاغ #40715 الرسالة نفسها في تطبيق ChatGPT لسطح المكتب على Windows، بسبب إدخال `mcp_servers.codex_app` لم يكتبه المستخدم أبدًا. وفي 26 أغسطس 2026 كتب مهندس من 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`. وعرض `codex mcp get logbrew` كل قيمة ضبطناها.

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

## حرّر إعدادات Claude Code يدويًا

هذا هو ملف `.mcp.json` الذي كتبه `--scope project` في اختبارنا. يطلب Claude Code من كل شخص الموافقة على الخادم في أول مرة يبدأ فيها داخل ذلك المشروع.

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

## أسئلة شائعة

### هل يدعم Claude Code خوادم MCP البعيدة؟

نعم. استخدم `--transport http` مع رابط الخادم. ويسجّل Claude Code دخولك عبر `/mcp` أو `claude mcp login` عندما يستخدم الخادم OAuth.

### أين يحفظ 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` أولًا إذا أردت أيضًا إلغاء رمز الوصول.

## دع وكيلك يقرأ أخطاء الإنتاج

يمنح خادم MCP من LogBrew كلًّا من Claude Code وCodex وأي عميل MCP آخر الأخطاء والسجلات والتتبّعات للمشاريع التي توافق عليها. ويكتفي بالقراءة ما لم تمنحه صلاحيات أكثر. ابدأ بخطة مجانية سخية دون بطاقة.

[اربط وكيلك](https://logbrew.co/ar/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)

## أدلة أخرى لوكلاء البرمجة بالذكاء الاصطناعي

- [استخدم AGENTS.md في Claude Code وCodex](https://logbrew.co/ar/guides/agents-md)
- [أصلح خطأ Claude overloaded 529 وخطأ rate limit 429](https://logbrew.co/ar/guides/claude-overloaded-rate-limit-error)
- [كيف تصلح الأخطاء في Claude Code وCodex وJavaScript في المتصفح](https://logbrew.co/ar/guides)