MCP

• 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

• 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

​

Doğru MCP yolunu seçin

​

MCP sunucusu olarak OpenClaw

​

serve ne zaman kullanılır

• 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

​

Nasıl çalışır

​

Bir istemci modu seçin

​

serve ne sunar

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

• 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 --verbose
openclaw mcp serve --claude-channel-mode off

​

Köprü araçları

​

Olay modeli

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

​

Claude kanal bildirimleri

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

• 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

​

MCP istemci yapılandırması

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

​

Seçenekler

​

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

• 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

​

Test Etme

pnpm test:docker:mcp-channels

• ö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

​

Sorun Giderme

​

MCP istemci kayıt defteri olarak OpenClaw

​

Kaydedilmiş MCP sunucu tanımları

• 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>

• 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.

openclaw mcp list
openclaw mcp show context7 --json
openclaw mcp status --verbose
openclaw mcp doctor --probe
openclaw mcp probe context7 --json
openclaw mcp add memory --command npx --arg -y --arg @modelcontextprotocol/server-memory
openclaw 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 docs
openclaw mcp logout docs
openclaw mcp unset context7

​

Yaygın sunucu tarifleri

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-memory
openclaw 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.example
openclaw 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

{
  "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": []
}

{
  "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ı

​

SSE / HTTP taşıması

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

​

OAuth iş akışı

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 --verbose
openclaw mcp doctor docs --probe

openclaw mcp logout docs

​

Streamable HTTP taşıması

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

​

Control UI

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.

• 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

• 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