한국어
문서
MCP 서버

MCP 서버

OpenCode는 로컬 및 원격 서버를 통해 외부 도구를 추가하기 위한 Model Context Protocol (MCP)을 지원합니다.

중요: MCP 서버는 컨텍스트에 데이터를 추가하므로 활성화할 서버를 신중히 선택하세요.

MCP 서버 활성화

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "server-name": {
      "enabled": true
    }
  }
}

로컬 MCP 서버

{
  "mcp": {
    "my-local-server": {
      "type": "local",
      "command": ["npx", "-y", "my-mcp-command"],
      "enabled": true,
      "environment": {
        "MY_ENV_VAR": "value"
      }
    }
  }
}

로컬 서버 옵션

옵션타입필수
typeString예 ("local")
commandArray
environmentObject아니오
timeoutNumber아니오 (기본값: 5000)

원격 MCP 서버

{
  "mcp": {
    "my-remote-server": {
      "type": "remote",
      "url": "https://my-mcp-server.com",
      "headers": {
        "Authorization": "Bearer API_KEY"
      }
    }
  }
}

OAuth 인증

opencode mcp auth server-name
opencode mcp list
opencode mcp logout server-name

MCP 도구 관리

전역

{
  "tools": {
    "my-mcp*": false
  }
}

에이전트별

{
  "agent": {
    "my-agent": {
      "tools": {
        "my-mcp*": true
      }
    }
  }
}

예시

Sentry

{
  "mcp": {
    "sentry": {
      "type": "remote",
      "url": "https://mcp.sentry.dev/mcp"
    }
  }
}

GitHub Code Search

{
  "mcp": {
    "gh_grep": {
      "type": "remote",
      "url": "https://mcp.grep.app"
    }
  }
}