** OpenClaw에 대한 Model Context Protocol (MCP) 통합 ** - MCP 서버에 연결하고 OpenClaw 내에서 도구를 원활하게 사용합니다.

개요

이 플러그인은 OpenClaw가 MCP (Model Context Protocol) 서버에 연결하고 AI 에이전트에 도구를 노출 할 수 있습니다. MCP Streamable HTTP 전송 사양을 구현하고 외부 MCP 도구를 호출하기위한 통합 인터페이스를 제공합니다.

✅ Real Working Example: REAL EXAMPLE KR LEGAL.md 를 참고해, kr-legal-search (NO API 키 필요 없음!)로 테스트를 완료하였습니다.

키 기능

✅ HTTP/SSE Transport - Server-Sent 이벤트와 MCP Streamable HTTP의 전체 지원 ✅ Dynamic Tool Discovery - MCP 서버에서 자동으로 발견 및 등록 도구 ✅ ** 멀티 서버 지원** - 여러 MCP 서버에 연결 ✅ Unified Interface - 단일 mcp 도구를 통해 모든 MCP 도구 ✅Error Handling - 굽힘 오류 처리 및 로깅

Pre Pre

• OpenClaw: 버전 2026.1.0 이상
• **Node.js **: 18.0.0 이상
• MCP 서버: 모든 MCP-compliant 서버와 HTTP 전송

♨ 설치

방법 1: OpenClaw 확장을 통해

OpenClaw MCP Integration Plugin

Model Context Protocol (MCP) integration for OpenClaw - Connect to MCP servers and use their tools seamlessly within OpenClaw.

🎯 Overview

This plugin enables OpenClaw to connect to any MCP (Model Context Protocol) server and expose its tools to AI agents. It implements the MCP Streamable HTTP transport specification and provides a unified interface for calling external MCP tools.

✅ Real Working Example: See REAL_EXAMPLE_KR_LEGAL.md for a complete, tested configuration with kr-legal-search (no API key required!).

Key Features

✅ HTTP/SSE Transport - Full support for MCP Streamable HTTP with Server-Sent Events
✅ Dynamic Tool Discovery - Automatically discovers and registers tools from MCP servers
✅ Multi-Server Support - Connect to multiple MCP servers simultaneously
✅ Unified Interface - All MCP tools accessible through a single mcp tool
✅ Error Handling - Robust error handling and logging

📋 Prerequisites

• OpenClaw: Version 2026.1.0 or higher
• Node.js: 18.0.0 or higher
• MCP Server: Any MCP-compliant server with HTTP transport

🚀 Installation

Method 1: Via OpenClaw Extensions

# Clone into OpenClaw extensions directory
cd ~/.openclaw/extensions/
git clone https://github.com/yourorg/mcp-integration.git

# Install dependencies
cd mcp-integration
npm install

# Restart OpenClaw
openclaw gateway restart

Method 2: Manual Installation

# Clone repository
git clone https://github.com/yourorg/mcp-integration.git
cd mcp-integration

# Install dependencies
npm install

# Link to OpenClaw
ln -s $(pwd) ~/.openclaw/extensions/mcp-integration

# Restart OpenClaw
openclaw gateway restart

⚙️ Configuration

Basic Configuration

Add to ~/.openclaw/openclaw.json:

{
  "plugins": {
    "entries": {
      "mcp-integration": {
        "enabled": true,
        "config": {
          "enabled": true,
          "servers": {
            "example-server": {
              "enabled": true,
              "transport": "http",
              "url": "http://localhost:3000/mcp"
            }
          }
        }
      }
    }
  }
}

Configuration Schema

{
  enabled: boolean;              // Enable/disable plugin (default: true)
  servers: {
    [serverName: string]: {
      enabled: boolean;          // Enable/disable this server (default: true)
      transport: "http";         // Transport type (currently only http supported)
      url: string;               // Server URL (e.g., "http://localhost:3000/mcp")
    }
  }
}

Multiple Servers Example

{
  "plugins": {
    "entries": {
      "mcp-integration": {
        "enabled": true,
        "config": {
          "enabled": true,
          "servers": {
            "kr-legal": {
              "enabled": true,
              "transport": "http",
              "url": "http://localhost:3000/mcp"