Kanji
・클라우드 엔지니어 / 프리랜서 ・1993년생 ・에히메현 출신 / 도쿄도 시부야구 거주 ・AWS 경력 5년 프로필 상세
목차
2025년 하반기부터 사내 도구와 개인 개발 환경에서 Antigravity와 Claude Code를 본격적으로 활용하면서, 제가 가장 먼저着手한 작업은 사내 DB와 BigQuery, 운영 스크립트를 호출하기 위한 원격 MCP(Model Context Protocol) 서버 구축이었습니다.
초기 MCP 생태계의 표준 통신 방식은 HTTP SSE(Server-Sent Events)를 이용한 스테이트풀 스트리밍이었습니다. 로컬 localhost 에서 테스트할 때는 아무런 문제가 없었지만, 이를 컨테이너로 패키징해 Google Cloud의 서버리스 컨테이너 기반인 Cloud Run에 배포한 순간 심각한 장애가 발생했습니다.
localhost
Cloud Run은 트래픽에 따라 컨테이너 인스턴스를 0개에서 수십 개까지 자동 확장하고 유휴 상태가 되면 즉시 컨테이너를 종료(Scale-to-Zero)합니다. 반면 구형 MCP 사양은 연결 시 initialize 핸드셰이크를 수행하고 서버가 발급한 Mcp-Session-Id 를 메모리에 유지한 채 후속 tools/call 요청에 계속 전달해야 했습니다. 이로 인해 현장에서는 다음과 같은 문제가 빈번히 발생했습니다.
initialize
Mcp-Session-Id
tools/call
404 Session Not Found
min-instances: 1
이 딜레마를 근본적으로 해결한 것이 2026년 7월 28일 발표된 ‘MCP 2026-07-28’ 대규모 사양 개정입니다.
▲ 로컬 AI 에이전트에서 Google Cloud IAM 인증을 통해 Cloud Run 기반 스테이트리스 MCP 서버에 접근하는 전체 아키텍처
신규 사양 ’2026-07-28’의 가장 큰 변화는 프로토콜 코어의 ‘완전 스테이트리스화’ 입니다.
_meta
Mcp-Method
Mcp-Name
서버리스 환경에서 특히 혁신적인 기능이 MRTR 입니다. 도구가 인간의 승인(Human-in-the-Loop)이나 추가 입력을 필요로 할 때, 서버는 연결을 열어두는 대신 input_required 상태와 continuation_token 을 반환하고 HTTP 요청을 즉시 정상 종료 합니다.
input_required
continuation_token
정적 API 키를 X-Api-Key 헤더에 담아 노출하는 대신, Cloud Run의 --no-allow-unauthenticated 설정과 roles/run.invoker IAM 역할, 그리고 OIDC ID 토큰 을 조합하여 제로트러스트 보안을 구현합니다.
X-Api-Key
--no-allow-unauthenticated
roles/run.invoker
# 0. 호출자 계정에 최소 권한 roles/run.invoker 부여 gcloud run services add-iam-policy-binding mcp-secops-server \ --region=asia-northeast1 \ --member="user:developer@example.com" \ --role="roles/run.invoker" # 1. Cloud Run 서비스 URL 조회 SERVICE_URL=$(gcloud run services describe mcp-secops-server --region asia-northeast1 --format 'value(status.url)') # 2. 대상 서비스 Audience가 일치하는 OIDC ID 토큰 동적 발급 ID_TOKEN=$(gcloud auth print-identity-token --audiences="${SERVICE_URL}") # 3. Mcp-Method 헤더와 Bearer 토큰으로 스테이트리스 호출 curl -s -X POST "${SERVICE_URL}/mcp" \ -H "Authorization: Bearer ${ID_TOKEN}" \ -H "Mcp-Method: tools/list" \ -H "Content-Type: application/json" \ -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}' | jq .
▲ Cloud Run 비인증 접근 차단(--no-allow-unauthenticated) 및 IAM 주체에 대한 roles/run.invoker 최소 권한 부여 검증
// src/server.ts import express, { Request, Response } from 'express'; const app = express(); app.use(express.json()); app.get('/healthz', (_req: Request, res: Response) => { res.status(200).send('OK'); }); app.post('/mcp', async (req: Request, res: Response) => { const mcpMethod = req.header('Mcp-Method') || req.body?.method; const requestId = req.body?.id ?? 1; if (mcpMethod === 'tools/list' || req.body?.method === 'tools/list') { return res.json({ jsonrpc: '2.0', id: requestId, result: { tools: [ { name: 'query_security_audit_logs', description: 'Cloud Logging에서 최근 보안 감사 이벤트를 조회합니다', inputSchema: { type: 'object', properties: { hoursAgo: { type: 'number', description: '조회 시간 범위 (기본값: 1)' }, severity: { type: 'string', enum: ['WARNING', 'ERROR', 'CRITICAL'] } }, required: ['severity'] } } ] } }); } if (mcpMethod === 'tools/call' || req.body?.method === 'tools/call') { const { name, arguments: args } = req.body.params; if (name === 'query_security_audit_logs') { const severity = args?.severity || 'ERROR'; const mockResult = [ { timestamp: new Date().toISOString(), severity: severity, resource: 'projects/my-prod-project/instances/db-01', message: 'IAM permission check failed for service account' } ]; return res.json({ jsonrpc: '2.0', id: requestId, result: { content: [{ type: 'text', text: JSON.stringify(mockResult, null, 2) }], isError: false } }); } return res.status(404).json({ jsonrpc: '2.0', id: requestId, error: { code: -32601, message: `Tool ${name} not found` } }); } return res.status(400).json({ jsonrpc: '2.0', id: requestId, error: { code: -32600, message: `Unsupported MCP method: ${mcpMethod}` } }); }); const PORT = process.env.PORT || 8080; app.listen(PORT, () => { console.log(`[MCP Server] Stateless Remote MCP listening on port ${PORT}`); });
FROM node:22-alpine AS builder WORKDIR /app COPY package*.json tsconfig.json ./ RUN npm ci COPY src ./src RUN npm run build FROM node:22-alpine AS runner WORKDIR /app ENV NODE_ENV=production COPY package*.json ./ RUN npm ci --only=production COPY --from=builder /app/dist ./dist USER node EXPOSE 8080 CMD ["node", "dist/server.js"]
PROJECT_ID="your-gcp-project-id" REGION="asia-northeast1" SERVICE_NAME="mcp-secops-server" gcloud run deploy "${SERVICE_NAME}" \ --source . \ --region "${REGION}" \ --project "${PROJECT_ID}" \ --no-allow-unauthenticated \ --min-instances 0 \ --max-instances 10 \ --cpu 1 \ --memory 512Mi \ --concurrency 80 \ --timeout 60s
mcp_config.json
{ "mcpServers": { "cloudrun-secops": { "command": "node", "args": [ "/usr/local/bin/cloudrun-mcp-proxy.js", "--url", "https://mcp-secops-server-xyz-an.a.run.app/mcp" ], "env": { "CLOUD_RUN_AUDIENCE": "https://mcp-secops-server-xyz-an.a.run.app" } } } }
로컬 테스트 시에는 gcloud run services proxy mcp-secops-server --region=asia-northeast1 --port=8080 명령으로 내장 IAM 인증 프록시를 구동하여 http://localhost:8080/mcp 로 손쉽게 연결할 수도 있습니다.
gcloud run services proxy mcp-secops-server --region=asia-northeast1 --port=8080
http://localhost:8080/mcp
▲ 원격 검증 환경에서 gcloud auth를 통한 OIDC ID 토큰 발급과 Mcp-Method 헤더 기반 스테이트리스 API 및 MRTR 동작 확인 로그
--min-instances 1
gcloud auth print-identity-token
Authorization
X-Upstream-Authorization
MCP 2026-07-28 사양의 완전 스테이트리스화 덕분에 이제 Cloud Run의 오토스케일링, 스케일 투 제로, 그리고 Google Cloud IAM 기반 제로트러스트 인증을100% 활용하여 안전하고 경제적인 원격 에이전트 도구 기반을 구축할 수 있습니다.
Real-time AI quant analysis of corporate earnings reports.
실전 같은 AI 음성 모의 통화와 5축 정밀 피드백. 16강 인터랙티브 강의와 스튜디오급 AI 프로필 생성 지원.
영수증 촬영 즉시 Gemini AI가 품목과 금액을 자동 인식. 모임 및 여행 경비를 손쉽게 더치페이하고 정산합니다.
점술사, 집사, 바텐더 AI 캐릭터가 직접 게임을 진행하고 대화 주제를 던져 모임을 흥미진진하게 만듭니다.
人工甘味料や添加物のNG除外と有効成分あたりの実質単価比較データベース。