MCP

openclaw mcp iki görevi vardır:

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

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

OpenClaw'ın bir kodlama çalıştırma ortamı 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çme

MCP sunucusu olarak OpenClaw

Bu, openclaw mcp serve yoludur.

serve ne zaman kullanılmalı?

openclaw mcp serve şu durumlarda kullanılmalıdır:

• Codex, Claude Code veya başka bir MCP istemcisinin OpenClaw destekli kanal konuşmalarıyla doğrudan iletişim kurması gerektiğinde
• yönlendirilmiş oturumları olan yerel veya uzak bir OpenClaw Gateway'iniz zaten varsa
• kanal başına ayrı 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 işlem MCP istemcisinin denetimindedir. İ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.

İstemci modu seçme

serve tarafından sunulanlar

Köprü, kanal destekli konuşmaları sunmak için mevcut Gateway oturum yönlendirme meta verilerini kullanır. OpenClaw'da aşağıdakiler gibi bilinen bir yönlendirmeye sahip oturum durumu zaten bulunduğ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 aşağıdakiler için tek bir yer sağlar:

• yakın tarihli yönlendirilmiş konuşmaları listelemek
• yakın tarihli döküm geçmişini okumak
• yeni gelen olayları beklemek
• aynı yönlendirme ü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ı

Olay modeli

Köprü, bağlı olduğu sürece bellek içi 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ü, Claude'a özgü kanal bildirimlerini de sunabilir. Bu, Claude Code kanal bağdaştırıcısının OpenClaw eşdeğeridir: standart MCP araçları kullanılabilir olmaya devam ederken canlı gelen iletiler Claude'a özgü MCP bildirimleri olarak da ulaşabilir.

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 döküm iletileri notifications/claude/channel olarak iletilir
• MCP üzerinden alınan Claude izin istekleri bellekte izlenir
• bağlantılı konuşmadaki komut sahibi daha sonra yes <id> veya no <id> gönderirse (<id>, l hariç 5 harfli istek kimliğidir), köprü bunu notifications/claude/channel/permission biçimine dönüştürür
• bu bildirimler yalnızca canlı oturumda kullanılabilir; MCP istemcisinin bağlantısı kesilirse gönderim hedefi kalmaz

Bu, kasıtlı olarak istemciye özgüdür. Genel MCP istemcileri standart yoklama araçlarını kullanmalıdır.

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 göz ardı edin. Claude modunu yalnızca Claude'a özgü bildirim yöntemlerini gerçekten anlayan istemcilerde açın.

Seçenekler

openclaw mcp serve şunları destekler:

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

Köprü yönlendirme oluşturmaz. Yalnızca Gateway'in zaten nasıl yönlendireceğini bildiği konuşmaları kullanıma sunar.

Bunun anlamı şudur:

• gönderen izin listeleri, eşleştirme ve kanal düzeyindeki güven hâlâ temel OpenClaw kanal yapılandırmasına aittir
• messages_send yalnızca mevcut bir kayıtlı rota üzerinden yanıt verebilir
• onay durumu yalnızca geçerli köprü oturumu için canlı/bellek içidir
• köprü kimlik doğrulaması, diğer tüm uzak Gateway istemcileri için güveneceğiniz Gateway token'ı veya parola denetimlerini kullanmalıdır

conversations_list içinde bir konuşma eksikse olağan neden MCP yapılandırması değildir. Temel Gateway oturumundaki rota meta verileri eksik veya tamamlanmamıştır.

Test

OpenClaw, bu köprü için deterministik bir Docker duman testiyle birlikte gelir:

pnpm test:docker:mcp-channels

Bu duman testi tek bir konteyner çalıştırır: konuşma durumunu hazırlar, Gateway'i başlatır, ardından openclaw mcp serve öğesini bir stdio alt süreci olarak oluşturur ve onu bir MCP istemcisi olarak kullanır. Gerçek stdio MCP köprüsü üzerinden konuşma keşfini, transkript okumalarını, ek meta verisi okumalarını, canlı olay kuyruğu davranışını ve Claude tarzı kanal ve izin bildirimlerini doğrular. Giden gönderim yönlendirmesi (kayıtlı konuşma rotasını yeniden kullanan messages_send) ayrıca src/mcp/channel-server.test.ts içindeki birim testleriyle kapsanır.

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 Test bölümüne bakın.

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'u MCP üzerinden kullanıma sunmaz. OpenClaw yapılandırmasında mcp.servers altındaki, OpenClaw tarafından yönetilen MCP sunucusu tanımlarını yönetir. 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'un daha sonra başlattığı veya yapılandırdığı çalışma zamanları içindir. OpenClaw, bu çalışma zamanlarının kendi yinelenen MCP sunucusu listelerini tutmasına gerek kalmaması için tanımları merkezi olarak depolar.

Çalışma zamanı bağdaştırıcıları, bu paylaşılan kayıt defterini alt istemcilerinin beklediği biçime 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'ya özgü type değerlerini alır.

Codex app-server ayrıca her sunucudaki isteğe bağlı bir codex bloğunu dikkate alır. Bu, yalnızca Codex app-server iş parçacıkları için OpenClaw yansıtma meta verisidir; ACP oturumlarını, genel Codex donanım 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 kimliklerine yansıtmak için boş olmayan codex.agents kullanın. Boş, yalnızca boşluk içeren veya geçersiz agent listeleri, genel hâle gelmek yerine yapılandırma doğrulaması tarafından reddedilir ve çalışma zamanı yansıtma yolundan çıkarılı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 kaldırır.

Kaydedilmiş MCP sunucusu tanımları

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.
• Ad olmadan show, yapılandırılmış MCP sunucusu 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. Komutun etkin sunucuların bağlandığını da doğrulaması gerekiyorsa --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ı bildirir.
• 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, sunucu tanımının tamamı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. Güncellenmiş sunucuyu kaydetmeden önce doğrulamak için --probe ekleyin.
• tools, sunucu başına araç filtrelerini günceller. Dahil etme/hariç tutma girdileri MCP araç adları ve basit * glob kalıpları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ış sunucunun depolanmış OAuth kimlik bilgilerini temizler.
• reload, yalnızca geçerli CLI süreci için önbelleğe alınmış süreç içi MCP çalışma zamanlarını sonlandırır. Başka bir süreçteki Gateway veya agent süreçlerinin yine kendi yeniden yükleme veya yeniden başlatma yoluna ihtiyacı vardır.
• Streamable HTTP MCP sunucuları için transport: "streamable-http" kullanın. openclaw mcp set, uyumluluk amacıyla CLI'ya özgü type: "http" değerini de aynı standart yapılandırma biçimine normalleştirir.
• unset, adlandırılmış sunucu mevcut değilse 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şlatıldığını ve araçları kullanıma sunduğunu doğrulamak için ardından openclaw mcp doctor --probe komutunu ç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 zaman içinde genişleyebileceğinden 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": true,  "path": "/home/user/.openclaw/openclaw.json",  "servers": [    {      "name": "docs",      "ok": true,      "issues": [        {          "level": "warning",          "message": "OAuth kimlik bilgileri yetkilendirilmemiş; openclaw mcp login docs komutunu çalıştırın"        }      ]    }  ]}

{  "generatedAt": "2026-05-31T09:00:00.000Z",  "servers": {    "docs": {      "launch": "streamable-http https://mcp.example.com/mcp",      "tools": 2,      "resources": true,      "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 aktarımı

Yerel bir alt işlem başlatır ve stdin/stdout üzerinden iletişim kurar.

SSE / HTTP aktarımı

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 (kullanıcı bilgileri) ve headers içindeki hassas değerler, günlüklerde ve durum çıktısında gizlenir. 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 commit edilmiş yapılandırmanın dışına taşıyabilir.

OAuth iş akışı

OAuth, MCP OAuth akışını bildiren HTTP MCP sunucuları içindir. auth: "oauth" etkin olduğunda bir sunucu için statik Authorization üstbilgileri yok sayılır. openclaw mcp login tarafından kaydedilen kimlik bilgileri; gömülü MCP, CLI çalıştırıcıları ve yerel Codex uygulama sunucusuyla çalışır.

Kimlik bilgileri kullanılabilir olana kadar OpenClaw, aracı turunu başarısız kılmak yerine yalnızca ilgili MCP sunucusunu aracı çalışma zamanından çıkarır. Ardından operatör veya kabuk erişimi olan bir aracı, openclaw mcp login <name> komutunu çalıştırıp sunucuyu sonraki bir turda kullanabilir.

Uzak bir MCP hizmeti zaten yenileme özellikli ayrı bir OpenClaw kimlik doğrulama profiliyle destekleniyorsa isteğe bağlı olarak oauth.authProfileId ayarlanabilir. OpenClaw, çalışma zamanı izdüşümünden önce iki kimlik bilgisi kaynağından birini yeniler ve aşağı akış MCP istemcisine yalnızca geçerli erişim token'ını iletir.

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

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

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ı belirteçleri döndürürse veya yetkilendirme durumu takılı kalırsa openclaw mcp logout <name> komutunu çalıştırın, ardından login işlemini tekrarlayın. Sunucu adı ve URL kimlik bilgisi deposu girdisini tanımlamaya devam ettiği sürece logout, auth: "oauth" yapılandırmadan kaldırıldıktan sonra bile kaydedilmiş bir HTTP sunucusunun kimlik bilgilerini temizleyebilir.

Akış destekli HTTP aktarımı

streamable-http, sse ve stdio ile birlikte kullanılabilen ek bir aktarım seçeneğidir. Uzak MCP sunucularıyla çift yönlü iletişim için HTTP akışını kullanır.

OpenClaw yapılandırması, standart yazım olarak transport: "streamable-http" kullanır. CLI'ye özgü 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 düzeltilir; ancak gömülü OpenClaw doğrudan transport değerini kullanır.

Örnek:

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

Denetim Arayüzü

Tarayıcı Denetim Arayüzü, /settings/mcp adresinde özel bir MCP ayarları sayfası içerir; önceki /mcp yolu takma ad olarak kalır. Sayfa; yapılandırılmış sunucu sayılarını, etkin/OAuth/filtre özetlerini, sunucu başına aktarım 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ı gerektiğinde 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 belirleyin.
2. Toplam, etkin, OAuth ve filtrelenmiş sunucular için özet kartlarını inceleyin.
3. Aktarım, 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ştirme durumunu 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ılaştırmak için Save, Gateway yapılandırma yolu üzerinden uygulamak için Save & Publish seçeneğini belirleyin.
7. Düzenlenen sunucunun başladığına ve araçları listelediğine dair canlı kanıt gerektiğinde openclaw mcp doctor --probe komutunu çalıştırın.

Notlar:

• komut parçacıkları, olağan dışı adların kabukta kopyalanabilir kalması için sunucu adlarını tırnak içine alır
• görüntülenen URL benzeri değerler, gömülü kimlik bilgileri içerdiğinde işlenmeden önce sansürlenir
• sayfa MCP aktarımlarını kendiliğinden başlatmaz
• MCP istemcilerinin hangi işlem tarafından yönetildiğine bağlı olarak etkin çalışma zamanlarında openclaw mcp reload, Gateway yapılandırmasını yayımlama veya işlemi yeniden başlatma gerekebilir

MCP Uygulamaları

OpenClaw, kararlı MCP Apps uzantısını uygulayan araçları işleyebilir. Uygulamaların HTML'i yapılandırılmış MCP sunucusundan geldiği ve aynı sunucudan uygulama tarafından görülebilen araçları veya kaynakları isteyebildiği için Uygulamalar isteğe bağlıdır.

Ana makine köprüsünü etkinleştirin:

openclaw config set mcp.apps.enabled true --strict-json

Bu ayarı değiştirdikten sonra Gateway'i yeniden başlatın. Etkinleştirildiğinde OpenClaw, Gateway bağlantı noktası artı birde (varsayılan Gateway için 18790) yalnızca korumalı alan için bir HTTP(S) dinleyicisi başlatır. Denetim Arayüzü, Uygulamaları bu ayrı kaynaktan yükler; dinleyici hiçbir zaman Denetim Arayüzü'nü, kimliği doğrulanmış Gateway rotalarını veya kullanıcı verilerini sunmaz.

Doğrudan Gateway bağlantılarının her iki bağlantı noktasına da erişmesi gerekir. Denetim Arayüzü'nü bir ters proxy veya TLS sonlandırıcı kullanıma sunuyorsa Uygulamalara özel bir genel kaynak verin ve yalnızca bu kaynağı korumalı alan dinleyicisine yönlendirin:

{  mcp: {    apps: {      enabled: true,      sandboxOrigin: "https://mcp-apps.example.com",      sandboxPort: 18790,    },  },}

Korumalı alan kaynağı, Denetim Arayüzü kaynağından farklı olmalıdır. Üzerinde kimliği doğrulanmış veya hassas başka içerikler barındırmayın.

Örneğin, resmî temel React demosu şu şekilde yapılandırılabilir:

{  mcp: {    apps: { enabled: true },    servers: {      "basic-react": {        command: "npx",        args: ["-y", "@modelcontextprotocol/server-basic-react", "--stdio"],      },    },  },}

Davranış ve güvenlik sınırları:

• OpenClaw, io.modelcontextprotocol/ui uzantısını yalnızca Uygulamalar etkinleştirildiğinde bildirir.
• Yalnızca tam olarak text/html;profile=mcp-app MIME türüne sahip ui:// kaynakları işlenir.
• Kullanıcı arayüzü kaynakları 2 MiB ile sınırlandırılır, özel bir dış kaynakta çift iframe proxy'sinin arkasına yerleştirilir, opak bir iç Uygulama kaynağına yüklenir ve kaynak meta verilerinden türetilen CSP ile kısıtlanır.
• Yalnızca Uygulamaya yönelik araçlar (_meta.ui.visibility: ["app"]) model araç listelerinin dışında kalır. Uygulamalar, yalnızca kendilerini yöneten sunucudaki uygulama tarafından görülebilen ve görünümü oluşturan çalıştırmanın geçerli OpenClaw araç politikasından da geçen araçları çağırabilir.
• İç Uygulama belgeleri Uygulamalar arası yalıtım için opak kaynaklar kullandığı sürece kamera, mikrofon ve coğrafi konum gibi kaynağa bağlı Uygulama izinleri verilmez.
• Uygulama HTML'i, eksiksiz araç bağımsız değişkenleri ve ham sonuçlar, sınırlandırılmış on dakikalık bir bellek içi görünüm kiralamasında tutulur; diske yazılmaz veya transkript önizleme meta verilerine kopyalanmaz. Transkript yalnızca özgün araç çağrısı kimliğine bağlı, sınırlandırılmış bir sunucu/araç/kaynak tanımlayıcısını saklar. Gateway yeniden başlatıldıktan sonra Denetim Arayüzü bu tanımlayıcıyı kimliği doğrulanmış oturum transkriptine göre doğrulayabilir ve ui:// kaynağını yeniden getirebilir; yeniden oluşturulan görünümler, yeni bir çalıştırma güncel araç izinlerini belirleyene kadar salt okunurdur.
• openclaw security audit, köprü etkinken uyarı verir. Gerekli olmadığında openclaw config set mcp.apps.enabled false --strict-json ile devre dışı bırakın.

Güncel sınırlamalar

Bu sayfa, köprüyü bugün sunulduğu hâliyle belgeler.

Güncel sınırlamalar:

• konuşma keşfi, mevcut Gateway oturum rotası meta verilerine bağlıdır
• Claude'a özgü bağdaştırıcının ötesinde genel bir anlık iletim protokolü yoktur
• henüz mesaj düzenleme veya tepki araçları yoktur
• HTTP/SSE/streamable-http aktarımı tek bir uzak sunucuya bağlanır; henüz çoğullanmış bir yukarı akış yoktur
• permissions_list_open yalnızca köprü bağlıyken gözlemlenen onayları içerir

İlgili

• CLI başvurusu
• Pluginler