YepCode MCP 서버란 무엇인가요?
AI 플랫폼이 YepCode 인프라와 상호 작용할 수 있도록 하는 MCP( 모델 컨텍스트 프로토콜 ) 서버입니다. LLM에서 생성된 스크립트를 실행하고 YepCode 프로세스를 AI 비서가 직접 사용할 수 있는 강력한 도구로 전환합니다.
왜 YepCode MCP 서버를 선택해야 할까요?
- 원활한 AI 통합 : YepCode 프로세스를 구성 없이 AI 지원 도구로 변환
- 실시간 프로세스 제어 : AI 시스템과 워크플로 간의 직접적인 상호 작용을 활성화합니다.
- 엔터프라이즈급 보안 : YepCode의 격리된 프로덕션 준비 환경에서 코드 실행
- 범용 호환성 : 모델 컨텍스트 프로토콜을 지원하는 모든 AI 플랫폼과 통합
통합 가이드
YepCode MCP 서버는 원격 접근 방식(MCP 서버의 호스팅 버전 제공)이나 로컬 접근 방식(NPX 또는 Docker 설치 필요)을 사용하여 Cursor 나 Claude Desktop 과 같은 AI 플랫폼과 통합할 수 있습니다.
SSE 서버를 사용한 원격 접근
- YepCode Cloud 에 가입하세요
- 작업 공간
Settings > API credentials 에서 MCP 서버 URL을 가져옵니다. - AI 플랫폼 설정에 다음 구성을 추가하세요.
지엑스피1
지역적 접근 방식
필수 환경 변수
YEPCODE_API_TOKEN : YepCode API 토큰입니다. 획득 방법:- YepCode Cloud 에 가입하세요
- 작업 공간에서 API 토큰을 가져오세요:
Settings > API credentials
NPX 사용하기
AI 플랫폼 설정에 다음 구성을 추가하세요.
{
"mcpServers": {
"yepcode-mcp-server": {
"command": "npx",
"args": ["-y", "@yepcode/mcp-server"],
"env": {
"YEPCODE_API_TOKEN": "your_api_token_here",
}
}
}
}
Docker 사용
- 컨테이너 이미지를 빌드합니다.
docker build -t yepcode/mcp-server .
- AI 플랫폼 설정에 다음 구성을 추가하세요.
{
"mcpServers": {
"yepcode-mcp-server": {
"command": "docker",
"args": [
"run",
"-d",
"-e",
"YEPCODE_API_TOKEN=your_api_token_here",
"yepcode/mcp-server"
]
}
}
}
디버깅
MCP 서버는 stdio를 통해 통신하기 때문에 디버깅이 까다로울 수 있습니다. 디버깅을 더 쉽게 하려면 다음 명령어로 실행할 수 있는 MCP Inspector를 사용하는 것이 좋습니다.
이렇게 하면 브라우저에서 직접 디버깅 도구에 액세스할 수 있는 서버가 시작됩니다.
YepCode MCP 도구 참조
MCP 서버는 YepCode 인프라와 상호 작용할 수 있는 여러 도구를 제공합니다.
코드 실행
실행 코드
YepCode의 보안 환경에서 코드를 실행합니다.
// Input
{
code: string; // The code to execute
options?: {
language?: string; // Programming language (default: 'javascript')
comment?: string; // Execution context
settings?: Record<string, unknown>; // Runtime settings
}
}
// Response
{
returnValue?: unknown; // Execution result
logs?: string[]; // Console output
error?: string; // Error message if execution failed
}
MCP 옵션
YepCode MCP 서버는 다음 옵션을 지원합니다.
- run_code 도구 비활성화: 경우에 따라
run_code 도구를 비활성화해야 할 수 있습니다. 예를 들어, YepCode 계정에 있는 기존 도구에 대해서만 MCP 서버를 공급자로 사용하려는 경우입니다. - run_code 정리 건너뛰기: 기본적으로 run_code 프로세스는 실행 후 소스 코드를 제거합니다. 감사 목적으로 소스 코드를 보관하려면 이 옵션을 사용할 수 있습니다.
옵션은 YEPCODE_MCP_OPTIONS 환경 변수에 쉼표로 구분된 목록으로 전달되거나 MCP 서버 URL에 쿼리 매개변수로 전달될 수 있습니다.
// SSE server configuration
{
"mcpServers": {
"yepcode-mcp-server": {
"url": "https://cloud.yepcode.io/mcp/sk-c2E....RD/sse?mcpOptions=disableRunCodeTool,skipRunCodeCleanup"
}
}
}
// NPX configuration
{
"mcpServers": {
"yepcode-mcp-server": {
"command": "npx",
"args": ["-y", "@yepcode/mcp-server"],
"env": {
"YEPCODE_API_TOKEN": "your_api_token_here",
"YEPCODE_MCP_OPTIONS": "disableRunCodeTool,skipRunCodeCleanup"
}
}
}
}
환경 관리
환경 변수 설정
YepCode 작업 공간에서 환경 변수를 설정합니다.
// Input
{
key: string; // Variable name
value: string; // Variable value
isSensitive?: boolean; // Whether to mask the value in logs (default: true)
}
환경 변수 제거
YepCode 작업 공간에서 환경 변수를 제거합니다.
// Input
{
key: string; // Name of the variable to remove
}
프로세스 실행
MCP 서버는 YepCode 프로세스를 개별 MCP 도구로 노출하여 AI 어시스턴트가 직접 접근할 수 있도록 합니다. 이 기능은 프로세스에 mcp-tool 태그를 추가하기만 하면 활성화됩니다( 프로세스 태그 에 대한 자세한 내용은 문서를 참조하세요).
노출된 각 프로세스마다 도구가 있습니다: run_ycp_<process_slug> (또는 도구 이름이 60자보다 긴 경우 run_ycp_<process_id> ).
run_ycp_<프로세스_슬러그>
// Input
{
parameters?: any; // This should match the input parameters specified in the process
options?: {
tag?: string; // Process version to execute
comment?: string; // Execution context
};
synchronousExecution?: boolean; // Whether to wait for completion (default: true)
}
// Response (synchronous execution)
{
executionId: string; // Unique execution identifier
logs: string[]; // Process execution logs
returnValue?: unknown; // Process output
error?: string; // Error message if execution failed
}
// Response (asynchronous execution)
{
executionId: string; // Unique execution identifier
}
get_execution
프로세스 실행 결과를 검색합니다.
// Input
{
executionId: string; // ID of the execution to retrieve
}
// Response
{
executionId: string; // Unique execution identifier
logs: string[]; // Process execution logs
returnValue?: unknown; // Process output
error?: string; // Error message if execution failed
}
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.