Intlayer MCP 서버

Intlayer MCP (Model Context Protocol) 서버는 Intlayer 생태계에 맞춤화된 AI 기반 IDE 지원을 제공합니다.

어디에서 사용할 수 있나요?

• Cursor, VS Code와 같은 최신 개발 환경 및 MCP 프로토콜을 지원하는 모든 IDE에서.
• Claude Desktop, Gemini, ChatGPT 등 좋아하는 AI 어시스턴트에서.

왜 Intlayer MCP 서버를 사용해야 하나요?

Intlayer MCP 서버를 IDE에서 활성화하면 다음과 같은 기능을 사용할 수 있습니다:

• 컨텍스트 인식 문서 MCP 서버는 Intlayer의 문서를 로드하고 노출합니다. 설정, 마이그레이션 등을 빠르게 진행할 수 있도록 도와줍니다. 이를 통해 코드 제안, 명령 옵션 및 설명이 항상 최신 상태이고 관련성이 유지됩니다.

• 스마트 CLI 통합 IDE 인터페이스에서 직접 Intlayer CLI 명령어에 접근하고 실행할 수 있습니다. MCP 서버를 사용하면 AI 어시스턴트가 intlayer dictionaries build 명령어로 사전을 업데이트하거나 intlayer dictionaries fill 명령어로 누락된 번역을 채우도록 할 수 있습니다.

  전체 명령어 및 옵션 목록은 Intlayer CLI 문서에서 확인하세요.

로컬 서버 (stdio) vs 원격 서버 (Streamable HTTP)

MCP 서버는 두 가지 방식으로 사용할 수 있습니다:

• 로컬 서버 (stdio)
• 원격 서버 (Streamable HTTP)

로컬 서버 (stdio) (권장)

Intlayer는 사용자의 컴퓨터에 로컬로 설치할 수 있는 NPM 패키지를 제공합니다. 이 패키지는 VS Code, Cursor와 같은 선호하는 IDE뿐만 아니라 ChatGPT, Claude Desktop 등과 같은 로컬 어시스턴트 애플리케이션에도 설치할 수 있습니다.

이 서버는 MCP 서버를 사용하는 권장 방법입니다. CLI 도구를 포함한 MCP 서버의 모든 기능이 통합되어 있기 때문입니다.

원격 서버 (Streamable HTTP)

MCP 서버는 Streamable HTTP 전송 방식을 사용하여 원격으로도 사용할 수 있습니다. 이 서버는 Intlayer에서 호스팅하며 https://mcp.intlayer.org 에서 이용할 수 있습니다. 이 서버는 인증 없이 공개적으로 접근할 수 있으며 무료로 사용할 수 있습니다.

원격 서버는 CLI 도구, AI 자동완성 등과 통합되어 있지 않다는 점에 유의하세요. 원격 서버는 Intlayer 생태계와 관련된 문서와 상호작용하여 AI 어시스턴트를 돕기 위한 용도로만 사용됩니다.

서버 호스팅 비용으로 인해 원격 서버의 가용성을 보장할 수 없습니다. 동시 연결 수를 제한하고 있습니다. 가장 안정적인 경험을 위해 로컬 서버(stdio) 전송 방식을 사용하는 것을 권장합니다.

Intlayer CLI를 통한 설정 (권장)

Intlayer는 프로젝트에서 MCP 서버를 자동으로 구성하는 CLI 명령을 제공합니다.

npx intlayer init mcp

이 명령은 다음을 수행합니다:

1. 사용 중인 플랫폼(Cursor, VS Code, Claude Desktop 등)을 묻습니다.
2. 사용하려는 전송 방식(로컬 서버(stdio) 또는 원격 서버(Streamable HTTP))을 묻습니다.
3. 구성 파일(예: .cursor/mcp.json, .vscode/mcp.json 또는 글로벌 Claude Desktop 설정)을 자동으로 업데이트합니다.

Setup via Intlayer VS Code extension

1. 명령 팔레트를 엽니다(Ctrl+Shift+P 또는 Cmd+Shift+P).
2. Intlayer: Setup AI Agent Skills를 입력합니다.
3. 사용하는 플랫폼을 선택합니다(예: VS Code, Cursor, Windsurf, OpenCode, Claude Code, GitHub Copilot Workspace 등).
4. 설치할 MCP를 선택합니다(stdio, Streamable HTTP).
5. Enter를 누릅니다.

Cursor에서 설정하기

Cursor에서 MCP 서버를 구성하려면 공식 문서를 참고하세요.

프로젝트 루트에 다음과 같은 .cursor/mcp.json 구성 파일을 추가합니다:

로컬 서버 (stdio) (권장)

{  "mcpServers": {    "intlayer": {      "command": "npx",      "args": ["-y", "@intlayer/mcp"]    }  }}

원격 서버 (Streamable HTTP)

Server-Sent Events (Streamable HTTP)를 사용하여 원격 Intlayer MCP 서버에 연결하려면, MCP 클라이언트를 호스팅된 서비스에 연결하도록 구성할 수 있습니다.

{  "mcpServers": {    "intlayer-sse": {      "command": "npx",      "args": ["-y", "mcp-remote@latest", "https://mcp.intlayer.org"]    }  }}

이 설정은 IDE가 npx를 사용하여 Intlayer MCP 서버를 실행하도록 하여, 버전을 고정하지 않는 한 항상 최신 버전을 사용하도록 보장합니다.

VS Code에서 설정하기

공식 문서를 참고하여 VS Code에서 MCP 서버를 구성하세요.

VS Code에서 Intlayer MCP 서버를 사용하려면 작업 공간 또는 사용자 설정에서 구성해야 합니다.

로컬 서버 (stdio) (권장)

프로젝트 루트에 .vscode/mcp.json 파일을 생성하세요:

{  "servers": {    "intlayer": {      "type": "stdio",      "command": "npx",      "args": ["-y", "@intlayer/mcp"]    }  }}

원격 서버 (Streamable HTTP)

Server-Sent Events (Streamable HTTP)를 사용하여 원격 Intlayer MCP 서버에 연결하려면, MCP 클라이언트를 호스팅된 서비스에 연결하도록 구성할 수 있습니다.

{  "servers": {    "intlayer-sse": {      "command": "npx",      "args": ["-y", "mcp-remote@latest", "https://mcp.intlayer.org"]    }  }}

ChatGPT 설정

원격 서버 (Streamable HTTP)

ChatGPT에서 MCP 서버를 구성하려면 공식 문서를 참조하세요.

1. 프롬프트 대시보드로 이동
2. + Create 클릭
3. Tools (Create or +) 클릭
4. MCP Server 선택
5. Add new 클릭

6. 다음 필드를 입력:

   • URL: https://mcp.intlayer.org
   • Label: Intlayer MCP Server
   • Name: intlayer-mcp-server
   • Authentication: None

7. Save 클릭

Claude Desktop 설정

공식 문서를 참고하여 Claude Desktop에서 MCP 서버를 설정하세요.

설정 파일 경로:

• macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

로컬 서버 (stdio) (권장)

{  "mcpServers": {    "intlayer": {      "command": "npx",      "args": ["-y", "@intlayer/mcp"]    }  }}

원격 서버 (Streamable HTTP)

{  "mcpServers": {    "intlayer-sse": {      "command": "npx",      "args": ["-y", "mcp-remote@latest", "https://mcp.intlayer.org"]    }  }}

CLI를 통한 MCP 서버 사용

테스트, 디버깅 또는 다른 도구와의 통합을 위해 Intlayer MCP 서버를 명령줄에서 직접 실행할 수도 있습니다.

# 전역 설치npm install -g @intlayer/mcp# 또는 npx로 직접 사용 (권장)npx @intlayer/mcp