MCP

openclaw mcp iki göreve sahiptir:

• openclaw mcp serve ile OpenClaw'ı MCP sunucusu olarak çalıştırmak
• OpenClaw'a ait giden MCP sunucu tanımlarını list, show, set ve unset ile yönetmek

Başka bir deyişle:

• serve, OpenClaw'ın MCP sunucusu gibi davranmasıdır
• list / show / set / unset, OpenClaw'ın çalışma zamanlarının daha sonra tüketebileceği diğer MCP sunucuları için MCP istemci tarafı kayıt defteri gibi 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.

# 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 istemcisinin doğrudan OpenClaw destekli kanal konuşmalarıyla iletişim kurması gerektiğinde
• yönlendirilmiş oturumlara sahip yerel veya uzak bir OpenClaw Gateway'iniz zaten olduğunda
• kanal başına ayrı köprüler çalıştırmak yerine OpenClaw'ın kanal arka uçlarında çalışan tek bir MCP sunucusu istediğinizde

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, 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 neleri 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 zaten varsa 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 döküm geçmişini okumak
• yeni gelen olayları beklemek
• aynı rota üzerinden geri 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 --verbose
openclaw 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 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, OpenClaw'ın Claude Code kanal adaptörü eşdeğeridir: 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 döküm mesajları notifications/claude/channel olarak iletilir
• MCP üzerinden alınan Claude izin istekleri bellekte izlenir
• bağlı konuşma daha sonra yes abcde veya no abcde gönderirse köprü bunu notifications/claude/channel/permission biçimine dönüştürür
• bu bildirimler yalnızca canlı oturum içindir; MCP istemcisi bağlantıyı keserse push hedefi yoktur

Bu kasıtlı olarak istemciye özgüdü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 icat etmez. Yalnızca Gateway'in zaten nasıl yönlendireceğini bildiği konuşmaları sunar.

Bu şu anlama gelir:

• gönderen izin listeleri, eşleme ve kanal düzeyi güven hâlâ altta yatan OpenClaw kanal yapılandırmasına aittir
• messages_send yalnızca mevcut saklanan bir 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ı, herhangi bir başka uzak Gateway istemcisi için güveneceğiniz aynı Gateway token veya parola denetimlerini kullanmalıdır

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

# Test

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

pnpm test:docker:mcp-channels

Bu smoke testi:

• 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, döküm okumalarını, ek meta veri 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.

# Sorun giderme

# MCP istemci kayıt defteri olarak OpenClaw

Bu, openclaw mcp list, show, set ve unset yoludur.

Bu komutlar OpenClaw'ı MCP üzerinden açığa çıkarmaz. OpenClaw yapılandırmasında mcp.servers altında OpenClaw'a ait MCP sunucu tanımlarını yönetirler.

Kaydedilen bu tanımlar, gömülü Pi 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 tanımları merkezi olarak saklar, böylece bu çalışma zamanlarının kendi yinelenen MCP sunucu listelerini tutması gerekmez.

Ç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ü Pi, 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.

# Kaydedilmiş MCP sunucu tanımları

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

Komutlar:

• openclaw mcp list
• openclaw mcp show [name]
• openclaw mcp set <name> <json>
• openclaw mcp unset <name>

Notlar:

• list sunucu adlarını sıralar.
• Ad olmadan show, yapılandırılmış MCP sunucu nesnesinin tamamını yazdırır.
• set, komut satırında tek bir JSON nesne değeri bekler.
• 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 biçimine normalleştirir.
• Adı verilen sunucu yoksa unset başarısız olur.

Örnekler:

openclaw mcp list
openclaw mcp show context7 --json
openclaw mcp set context7 '{"command":"uvx","args":["context7-mcp"]}'
openclaw mcp set docs '{"url":"https://mcp.example.com","transport":"streamable-http"}'
openclaw mcp unset context7

Örnek yapılandırma biçimi:

{
  "mcp": {
    "servers": {
      "context7": {
        "command": "uvx",
        "args": ["context7-mcp"]
      },
      "docs": {
        "url": "https://mcp.example.com",
        "transport": "streamable-http"
      }
    }
  }
}

# Stdio aktarımı

Yerel bir alt süreç 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",
        "headers": {
          "Authorization": "Bearer <token>"
        }
      }
    }
  }
}

url içindeki hassas değerler (userinfo) ve headers, günlüklerde ve durum çıktısında gizlenir.

# Streamable HTTP aktarımı

streamable-http, sse ve stdio yanında 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ı kanonik yazım olarak transport: "streamable-http" kullanır. CLI'ye özgü MCP type: "http" değerleri, openclaw mcp set üzerinden kaydedildiğinde kabul edilir ve mevcut yapılandırmada openclaw doctor --fix tarafından onarılır, ancak gömülü Pi'nin doğrudan tükettiği şey transport değeridir.

Örnek:

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

# Mevcut sınırlar

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

Mevcut sınırlar:

• konuşma keşfi mevcut Gateway oturum rota meta verilerine bağlıdır
• Claude'a özgü bağdaştırıcının ötesinde genel bir anında iletme 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ğaltılmış üst akış yoktur
• permissions_list_open yalnızca köprü bağlıyken gözlemlenen onayları içerir

# İlgili

• CLI başvurusu
• Pluginler