MCP

openclaw mcp iki göreve sahiptir:

• OpenClaw'ı openclaw mcp serve ile bir MCP sunucusu olarak çalıştırmak
• OpenClaw tarafından yönetilen giden MCP sunucusu tanımlarını list, show, status, doctor, probe, add, set, configure, tools, login, logout, reload ve unset ile yönetmek

Başka bir deyişle:

• serve, OpenClaw'ın bir MCP sunucusu olarak davranmasıdır
• diğer alt komutlar, OpenClaw'ın çalışma zamanlarının daha sonra kullanabileceği MCP sunucuları için MCP istemci tarafı kayıt defteri olarak davranmasıdır

OpenClaw'ın bir kodlama harness oturumunu kendisinin barındırması ve bu çalışma zamanını ACP üzerinden yönlendirmesi gerektiğinde openclaw acp kullanın.

Doğru MCP yolunu seçin

OpenClaw'ın birkaç MCP yüzeyi vardır. Ajan çalışma zamanının sahibine ve araçların sahibine uyanı seçin.

MCP sunucusu olarak OpenClaw

Bu, openclaw mcp serve yoludur.

serve ne zaman kullanılır

openclaw mcp serve komutunu şu durumlarda kullanın:

• Codex, Claude Code veya başka bir MCP istemcisi OpenClaw destekli kanal konuşmalarıyla doğrudan konuşmalıysa
• yönlendirilmiş oturumları olan yerel veya uzak bir OpenClaw Gateway'iniz zaten varsa
• ayrı kanal başına köprüler çalıştırmak yerine OpenClaw'ın kanal arka uçlarında çalışan tek bir MCP sunucusu istiyorsanız

OpenClaw'ın kodlama çalışma zamanını kendisinin barındırması ve ajan oturumunu OpenClaw içinde tutması gerektiğinde bunun yerine openclaw acp kullanın.

Nasıl çalışır

openclaw mcp serve, bir stdio MCP sunucusu başlatır. Bu sürecin sahibi MCP istemcisidir. İstemci stdio oturumunu açık tuttuğu sürece köprü, WebSocket üzerinden yerel veya uzak bir OpenClaw Gateway'e bağlanır ve yönlendirilmiş kanal konuşmalarını MCP üzerinden sunar.

Bir istemci modu seçin

Aynı köprüyü iki farklı şekilde kullanın:

serve ne sunar

Köprü, kanal destekli konuşmaları sunmak için mevcut Gateway oturum rota meta verilerini kullanır. OpenClaw'ın aşağıdakiler gibi bilinen bir rotaya sahip oturum durumu olduğunda bir konuşma görünür:

• channel
• alıcı veya hedef meta verileri
• isteğe bağlı accountId
• isteğe bağlı threadId

Bu, MCP istemcilerine şunlar için tek bir yer sağlar:

• son yönlendirilmiş konuşmaları listelemek
• son transkript geçmişini okumak
• yeni gelen olayları beklemek
• aynı rota üzerinden yanıt göndermek
• köprü bağlıyken gelen onay isteklerini görmek

Kullanım

openclaw mcp serve

openclaw mcp serve --url wss://gateway-host:18789 --token-file ~/.openclaw/gateway.token

openclaw mcp serve --url wss://gateway-host:18789 --password-file ~/.openclaw/gateway.password

openclaw mcp serve --verboseopenclaw mcp serve --claude-channel-mode off

Köprü araçları

Geçerli köprü şu MCP araçlarını sunar:

Olay modeli

Köprü, bağlı olduğu sürece bellekte bir olay kuyruğu tutar.

Geçerli olay türleri:

• message
• exec_approval_requested
• exec_approval_resolved
• plugin_approval_requested
• plugin_approval_resolved
• claude_permission_request

Claude kanal bildirimleri

Köprü ayrıca Claude'a özgü kanal bildirimleri de sunabilir. Bu, Claude Code kanal adaptörünün OpenClaw karşılığıdır: standart MCP araçları kullanılabilir kalır, ancak canlı gelen mesajlar Claude'a özgü MCP bildirimleri olarak da gelebilir.

Claude kanal modu etkinleştirildiğinde sunucu Claude deneysel yeteneklerini duyurur ve şunları yayabilir:

• notifications/claude/channel
• notifications/claude/channel/permission

Geçerli köprü davranışı:

• gelen user transkript mesajları notifications/claude/channel olarak iletilir
• MCP üzerinden alınan Claude izin istekleri bellekte izlenir
• bağlantılı konuşmadaki komut sahibi daha sonra yes abcde veya no abcde gönderirse köprü bunu notifications/claude/channel/permission öğesine dönüştürür
• bu bildirimler yalnızca canlı oturuma aittir; MCP istemcisi bağlantıyı keserse anlık bildirim hedefi kalmaz

Bu özellikle istemciye özgü olacak şekilde tasarlanmıştır. Genel MCP istemcileri standart yoklama araçlarına güvenmelidir.

MCP istemci yapılandırması

Örnek stdio istemci yapılandırması:

{  "mcpServers": {    "openclaw": {      "command": "openclaw",      "args": [        "mcp",        "serve",        "--url",        "wss://gateway-host:18789",        "--token-file",        "/path/to/gateway.token"      ]    }  }}

Çoğu genel MCP istemcisi için standart araç yüzeyiyle başlayın ve Claude modunu yok sayın. Claude modunu yalnızca Claude'a özgü bildirim yöntemlerini gerçekten anlayan istemciler için açın.

Seçenekler

openclaw mcp serve şunları destekler:

Güvenlik ve güven sınırı

Köprü yönlendirme uydurmaz. Yalnızca Gateway'in zaten nasıl yönlendireceğini bildiği konuşmaları açığa çıkarır.

Bu şu anlama gelir:

• gönderen izin listeleri, eşleştirme ve kanal düzeyi güven hâlâ alttaki OpenClaw kanal yapılandırmasına aittir
• messages_send yalnızca mevcut bir saklanmış rota üzerinden yanıt verebilir
• onay durumu yalnızca geçerli köprü oturumu için canlı/bellek içindedir
• köprü kimlik doğrulaması, başka herhangi bir uzak Gateway istemcisi için güveneceğiniz aynı Gateway belirteci veya parola denetimlerini kullanmalıdır

Bir konuşma conversations_list içinde eksikse, olağan neden MCP yapılandırması değildir. Alttaki Gateway oturumunda eksik veya tamamlanmamış rota meta verileridir.

Test Etme

OpenClaw bu köprü için deterministik bir Docker smoke testiyle gelir:

pnpm test:docker:mcp-channels

Bu smoke testi:

• önceden tohumlanmış bir Gateway kapsayıcısı başlatır
• openclaw mcp serve başlatan ikinci bir kapsayıcı başlatır
• konuşma keşfini, transkript okumalarını, ek meta verisi okumalarını, canlı olay kuyruğu davranışını ve giden gönderim yönlendirmesini doğrular
• gerçek stdio MCP köprüsü üzerinden Claude tarzı kanal ve izin bildirimlerini doğrular

Bu, test çalıştırmasına gerçek bir Telegram, Discord veya iMessage hesabı bağlamadan köprünün çalıştığını kanıtlamanın en hızlı yoludur.

Daha geniş test bağlamı için bkz. Test Etme.

Sorun Giderme

MCP istemci kayıt defteri olarak OpenClaw

Bu, openclaw mcp list, show, status, doctor, probe, add, set, configure, tools, login, logout, reload ve unset yoludur.

Bu komutlar OpenClaw'ı MCP üzerinden açığa çıkarmaz. OpenClaw yapılandırmasında mcp.servers altında OpenClaw tarafından yönetilen MCP sunucu tanımlarını yönetirler. config/mcporter.json içindeki mcporter sunucularını okumazlar.

Kaydedilen bu tanımlar, gömülü OpenClaw ve diğer çalışma zamanı bağdaştırıcıları gibi OpenClaw'ın daha sonra başlattığı veya yapılandırdığı çalışma zamanları içindir. OpenClaw, bu çalışma zamanlarının kendi yinelenen MCP sunucu listelerini tutmak zorunda kalmaması için tanımları merkezi olarak depolar.

Çalışma zamanı bağdaştırıcıları, bu paylaşılan kayıt defterini aşağı akış istemcilerinin beklediği şekle normalleştirebilir. Örneğin, gömülü OpenClaw, OpenClaw transport değerlerini doğrudan tüketirken Claude Code ve Gemini, http, sse veya stdio gibi CLI'ye özgü type değerleri alır.

Codex app-server ayrıca her sunucuda isteğe bağlı bir codex bloğunu dikkate alır. Bu yalnızca Codex app-server iş parçacıkları için OpenClaw projeksiyon meta verisidir; ACP oturumlarını, genel Codex harness yapılandırmasını veya diğer çalışma zamanı bağdaştırıcılarını değiştirmez. Bir sunucuyu yalnızca belirli OpenClaw agent id'lerine yansıtmak için boş olmayan codex.agents kullanın. Boş, yalnızca boşluk içeren veya geçersiz agent listeleri yapılandırma doğrulaması tarafından reddedilir ve global hale gelmek yerine çalışma zamanı projeksiyon yolunda atlanır. Güvenilir bir sunucu için Codex'in yerel default_tools_approval_mode değerini yaymak üzere codex.defaultToolsApprovalMode (auto, prompt veya approve) kullanın. OpenClaw, yerel mcp_servers yapılandırmasını Codex'e vermeden önce codex meta verilerini çıkarır.

Kaydedilmiş MCP sunucu tanımları

OpenClaw ayrıca OpenClaw tarafından yönetilen MCP tanımları isteyen yüzeyler için yapılandırmada hafif bir MCP sunucu kayıt defteri depolar.

Komutlar:

• openclaw mcp list
• openclaw mcp show [name]
• openclaw mcp status [--verbose]
• openclaw mcp doctor [name] [--probe]
• openclaw mcp probe [name]
• openclaw mcp add <name> [flags]
• openclaw mcp set <name> <json>
• openclaw mcp configure <name> [flags]
• openclaw mcp tools <name> [--include csv] [--exclude csv] [--clear]
• openclaw mcp login <name> [--code code]
• openclaw mcp logout <name>
• openclaw mcp reload
• openclaw mcp unset <name>

Notlar:

• list sunucu adlarını sıralar.
• show, ad verilmeden çalıştırıldığında yapılandırılmış MCP sunucu nesnesinin tamamını yazdırır.
• status, yapılandırılmış aktarımları bağlanmadan sınıflandırır. --verbose çözümlenmiş başlatma, zaman aşımı, OAuth, filtre ve paralel çağrı ayrıntılarını içerir.
• doctor, bağlanmadan statik denetimler gerçekleştirir. Komut etkin sunucuların bağlandığını da doğrulamalıysa --probe ekleyin.
• probe bağlanır ve araç sayılarını, kaynak/istem desteğini, liste değişikliği desteğini ve tanıları raporlar.
• add, --command, --arg, --env ve --cwd gibi stdio bayraklarını veya --url, --transport, --header, --auth oauth, TLS, zaman aşımı ve araç seçimi bayrakları gibi HTTP bayraklarını kabul eder.
• set, komut satırında tek bir JSON nesne değeri bekler.
• configure, tüm sunucu tanımını değiştirmeden etkinleştirmeyi, araç filtrelerini, zaman aşımlarını, OAuth'u, TLS'yi ve paralel araç çağrısı ipuçlarını günceller.
• tools, sunucu başına araç filtrelerini günceller. Include/exclude girdileri MCP araç adları ve basit * glob'larıdır.
• login, auth: "oauth" ile yapılandırılmış HTTP sunucuları için OAuth akışını çalıştırır. İlk çalıştırma bir yetkilendirme URL'si yazdırır; onaydan sonra --code ile yeniden çalıştırın.
• logout, kayıtlı sunucu tanımını kaldırmadan adlandırılmış sunucu için saklanan OAuth kimlik bilgilerini temizler.
• reload, önbelleğe alınmış süreç içi MCP çalışma zamanlarını elden çıkarır. Başka bir süreçteki Gateway veya ajan süreçleri yine kendi yeniden yükleme veya yeniden başlatma yoluna ihtiyaç duyar.
• Streamable HTTP MCP sunucuları için transport: "streamable-http" kullanın. openclaw mcp set, uyumluluk için CLI'ye özgü type: "http" değerini de aynı kanonik yapılandırma şekline normalleştirir.
• unset, adlandırılmış sunucu yoksa başarısız olur.

Örnekler:

openclaw mcp listopenclaw mcp show context7 --jsonopenclaw mcp status --verboseopenclaw mcp doctor --probeopenclaw mcp probe context7 --jsonopenclaw mcp add memory --command npx --arg -y --arg @modelcontextprotocol/server-memoryopenclaw mcp set context7 '{"command":"uvx","args":["context7-mcp"]}'openclaw mcp tools context7 --include 'resolve-library-id,get-library-docs'openclaw mcp set docs '{"url":"https://mcp.example.com","transport":"streamable-http"}'openclaw mcp configure docs --timeout 20 --connect-timeout 5 --include 'search,read_*'openclaw mcp configure docs --auth oauth --oauth-scope 'docs.read'openclaw mcp login docsopenclaw mcp logout docsopenclaw mcp unset context7

Yaygın sunucu tarifleri

Bu örnekler yalnızca sunucu tanımlarını kaydeder. Sunucunun başladığını ve araçları açığa çıkardığını kanıtlamak için ardından openclaw mcp doctor --probe çalıştırın.

openclaw mcp add files \  --command npx \  --arg -y \  --arg @modelcontextprotocol/server-filesystem \  --arg "$HOME/Documents" \  --include 'read_file,list_directory,search_files'openclaw mcp doctor files --probe

openclaw mcp add memory \  --command npx \  --arg -y \  --arg @modelcontextprotocol/server-memoryopenclaw mcp probe memory --json

openclaw mcp add local-tools \  --command node \  --arg ./dist/mcp-server.js \  --cwd /srv/openclaw-tools \  --env API_BASE=https://internal.exampleopenclaw mcp status --verbose

openclaw mcp add docs \  --url https://mcp.example.com/mcp \  --transport streamable-http \  --auth oauth \  --oauth-scope docs.read \  --timeout 20 \  --connect-timeout 5 \  --include 'search,read_*'openclaw mcp doctor docs --probe

openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'openclaw mcp tools cua-driver --include 'list_apps,observe,click,type'openclaw mcp doctor cua-driver --probe

JSON çıktı biçimleri

Betikler ve panolar için --json kullanın. Alan kümeleri zamanla büyüyebilir; bu nedenle tüketiciler bilinmeyen anahtarları yok saymalıdır.

{  "path": "/home/user/.openclaw/openclaw.json",  "servers": [    {      "name": "docs",      "configured": true,      "enabled": true,      "ok": true,      "transport": "streamable-http",      "launch": "streamable-http https://mcp.example.com/mcp",      "auth": "oauth",      "authStatus": {        "hasTokens": true,        "hasClientInformation": true,        "hasCodeVerifier": false,        "hasDiscoveryState": true,        "hasLastAuthorizationUrl": false      },      "requestTimeoutMs": 20000,      "connectionTimeoutMs": 5000,      "toolFilter": {        "include": ["search", "read_*"],        "exclude": []      },      "supportsParallelToolCalls": true    }  ]}

{  "ok": false,  "path": "/home/user/.openclaw/openclaw.json",  "servers": [    {      "name": "docs",      "ok": false,      "issues": [        {          "level": "error",          "message": "OAuth credentials are not authorized; run openclaw mcp login docs"        }      ]    }  ]}

{  "path": "/home/user/.openclaw/openclaw.json",  "generatedAt": "2026-05-31T09:00:00.000Z",  "servers": {    "docs": {      "launch": "streamable-http https://mcp.example.com/mcp",      "tools": 2,      "resources": true,      "prompts": false,      "listChanged": {        "tools": true,        "resources": false,        "prompts": false      }    }  },  "tools": ["docs__read_page", "docs__search"],  "diagnostics": []}

Örnek yapılandırma biçimi:

{  "mcp": {    "servers": {      "context7": {        "command": "uvx",        "args": ["context7-mcp"]      },      "docs": {        "url": "https://mcp.example.com",        "transport": "streamable-http",        "timeout": 20,        "connectTimeout": 5,        "supportsParallelToolCalls": true,        "auth": "oauth",        "oauth": {          "scope": "docs.read"        },        "sslVerify": true,        "clientCert": "/path/to/client.crt",        "clientKey": "/path/to/client.key",        "toolFilter": {          "include": ["search_*"],          "exclude": ["admin_*"]        }      }    }  }}

Stdio taşıması

Yerel bir alt süreç başlatır ve stdin/stdout üzerinden iletişim kurar.

SSE / HTTP taşıması

HTTP Server-Sent Events üzerinden uzak bir MCP sunucusuna bağlanır.

Örnek:

{  "mcp": {    "servers": {      "remote-tools": {        "url": "https://mcp.example.com",        "auth": "oauth",        "timeout": 20,        "headers": {          "Authorization": "Bearer <token>"        }      }    }  }}

url içindeki hassas değerler (userinfo) ve headers günlüklerde ve durum çıktısında maskelenir. openclaw mcp doctor, hassas görünümlü headers veya env girdileri değişmez değerler içerdiğinde uyarır; böylece operatörler bu değerleri işlemeye alınmış yapılandırmanın dışına taşıyabilir.

OAuth iş akışı

OAuth, MCP OAuth akışını duyuran HTTP MCP sunucuları içindir. auth: "oauth" etkin olduğu sürece bir sunucu için statik Authorization üstbilgileri yok sayılır.

openclaw mcp set docs '{"url":"https://mcp.example.com/mcp","transport":"streamable-http","auth":"oauth","oauth":{"scope":"docs.read"}}'

openclaw mcp login docs

openclaw mcp login docs --code abc123

openclaw mcp status --verboseopenclaw mcp doctor docs --probe

openclaw mcp logout docs

Sağlayıcı tokenları döndürürse veya yetkilendirme durumu takılı kalırsa openclaw mcp logout <name> çalıştırın, ardından login işlemini yineleyin. auth: "oauth" yapılandırmadan kaldırılmış olsa bile, sunucu adı ve URL kimlik bilgisi deposu girdisini hâlâ tanımladığı sürece logout kaydedilmiş bir HTTP sunucusunun kimlik bilgilerini temizleyebilir.

Streamable HTTP taşıması

streamable-http, sse ve stdio yanında ek bir taşıma seçeneğidir. Uzak MCP sunucularıyla çift yönlü iletişim için HTTP akışını kullanır.

OpenClaw yapılandırması, kanonik yazım olarak transport: "streamable-http" kullanır. CLI yerel MCP type: "http" değerleri openclaw mcp set aracılığıyla kaydedildiğinde kabul edilir ve mevcut yapılandırmada openclaw doctor --fix tarafından onarılır; ancak gömülü OpenClaw'ın doğrudan tükettiği alan transport alanıdır.

Örnek:

{  "mcp": {    "servers": {      "streaming-tools": {        "url": "https://mcp.example.com/stream",        "transport": "streamable-http",        "connectTimeout": 10,        "timeout": 30,        "headers": {          "Authorization": "Bearer <token>"        }      }    }  }}

Control UI

Tarayıcı Control UI, /mcp konumunda özel bir MCP ayarları sayfası içerir. Yapılandırılmış sunucu sayılarını, etkin/OAuth/filtre özetlerini, sunucu başına taşıma satırlarını, etkinleştirme/devre dışı bırakma denetimlerini, yaygın CLI komutlarını ve mcp yapılandırma bölümü için kapsamlı bir düzenleyiciyi gösterir.

Sayfayı operatör düzenlemeleri ve hızlı envanter için kullanın. Canlı sunucu kanıtına ihtiyaç duyduğunuzda openclaw mcp doctor --probe veya openclaw mcp probe kullanın.

Operatör iş akışı:

1. Denetim Arayüzü'nü açın ve MCP seçeneğini seçin.
2. Toplam, etkin, OAuth ve filtrelenmiş sunucular için özet kartlarını inceleyin.
3. Taşıma, kimlik doğrulama, filtre, zaman aşımı ve komut ipuçları için her sunucu satırını kullanın.
4. Bir tanımı korumak ancak çalışma zamanı keşfinin dışında bırakmak istediğinizde etkinleştirmeyi değiştirin.
5. Yeni sunucular, üst bilgiler, TLS, OAuth meta verileri veya araç filtreleri gibi yapısal değişiklikler için kapsamlı mcp yapılandırma bölümünü düzenleyin.
6. Yalnızca yapılandırmayı kalıcı hale getirmek için Kaydet seçeneğini, Gateway yapılandırma yolu üzerinden uygulamak için Kaydet ve Yayınla seçeneğini seçin.
7. Düzenlenen sunucunun başlatıldığına ve araçları listelediğine dair canlı kanıta ihtiyaç duyduğunuzda openclaw mcp doctor --probe komutunu çalıştırın.

Notlar:

• komut parçacıkları sunucu adlarını tırnak içine alır, böylece alışılmadık adlar bir kabukta kopyalanabilir kalır
• görüntülenen URL benzeri değerler, gömülü kimlik bilgileri içerdiklerinde işlenmeden önce redakte edilir
• sayfa MCP taşımalarını kendiliğinden başlatmaz
• etkin çalışma zamanları, MCP istemcilerinin hangi süreç tarafından sahiplenildiğine bağlı olarak openclaw mcp reload, Gateway yapılandırma yayını veya süreç yeniden başlatması gerektirebilir

Geçerli sınırlar

Bu sayfa, köprüyü bugün sevk edildiği haliyle belgeler.

Geçerli sınırlar:

• konuşma keşfi, mevcut Gateway oturum rotası meta verilerine bağlıdır
• Claude'a özgü adaptör dışında genel bir anında iletme protokolü yoktur
• henüz ileti düzenleme veya tepki araçları yoktur
• HTTP/SSE/streamable-http taşıması tek bir uzak sunucuya bağlanır; henüz çoğullamalı upstream yoktur
• permissions_list_open yalnızca köprü bağlıyken gözlemlenen onayları içerir

İlgili

• CLI referansı
• Plugins