연동 키트API 연동MCP Ruby SDK
Ruby 서비스를 MCP 기반 AI 도구로 연동
- 누가 · 어디에
- Ruby 또는 Rails 기반 백엔드를 운영하며 사내 데이터·API를 AI 에이전트에 도구로 제공하려는 백엔드 개발자
- 업무 효과
- 공식 Tier 1 검증을 마친 표준 SDK로 최신 MCP 규격을 완벽 지원하며, 안정적인 LLM 도구 연동을 구현합니다.
공식 API · SDK 로 우리 시스템에 붙입니다. AI 가 공식 문서를 찾아 정리한 가이드로, mopick 이 직접 따라 해 보지는 않았습니다 · 공식 문서에서 제품을 확인했습니다
준비할 것
- Ruby 2.7 이상 실행 환경
- Bundler 또는 RubyGems 패키지 관리자
- 연동 테스트용 MCP 호스트(Claude Desktop 등)
연동 단계
해 본 단계는 번호를 눌러 표시하세요. 표시는 이 브라우저에만 남습니다.
0% 진행
SDK 패키지 설치
Gemfile에 gem 'mcp'를 추가하고 bundle install을 실행하거나, 터미널에서 gem install mcp를 입력해 SDK를 설치합니다.
MCP 도구 구현
MCP::Tool 클래스를 상속받아 description, input_schema 및 실행 메서드(self.call)를 포함하는 도구 스크립트를 작성합니다.
서버 및 전송 설정
MCP::Server.new로 도구를 등록하고 StdioTransport.new(server).open을 호출해 표준 입출력 전송 환경을 구동합니다.
MCP 호스트 연동
Claude Desktop 설정 파일(claude_desktop_config.json)의 mcpServers 섹션에 해당 Ruby 스크립트 실행 명령을 추가합니다.
붙여 넣는 설정 · 코드
YOUR_API_KEY 같은 자리에는 내 값을 넣으세요. 키는 코드 · 문서에 그대로 남기지 말고 환경 변수 · 비밀 저장소에 두세요.
server.rb ruby
require "mcp"
class EchoTool < MCP::Tool
description "입력 메시지를 반환하는 도구"
input_schema(
properties: { message: { type: "string" } },
required: ["message"]
)
def self.call(message:, server_context:)
MCP::Tool::Response.new([
{ type: "text", text: "서버 응답: #{message}" }
])
end
end
server = MCP::Server.new(name: "ruby_mcp_server", tools: [EchoTool])
transport = MCP::Server::Transports::StdioTransport.new(server)
transport.openclaude_desktop_config.json json
{
"mcpServers": {
"ruby-service": {
"command": "ruby",
"args": ["/path/to/server.rb"]
}
}
}- 잘 연결됐는지 확인
- 실행 중인 Ruby 서버 표준 입력으로 '{"jsonrpc":"2.0","id":"1","method":"ping"}'을 보내 정상 응답을 확인합니다.
- 비용
- 오픈소스 라이선스(Apache-2.0)로 무료
- 주의
- · Streamable HTTP 및 SSE 전송 방식 운영 시 비인가 호출 방지를 위해 OAuth 2.1 인증 보호를 구성해야 합니다.
- · 2026-07-28 스테이트리스 사양과 이전 핸드셰이크 사양 간 클라이언트 호환성 동작 여부를 사전에 검증해야 합니다.
공식 문서
우리 회사 시스템에 붙여야 한다면 — 업무 앱 · 사내 자료 · 보안 조건에 맞춘 연동을 TPI INSIGHT AX센터가 함께합니다.