Omnisend MCP 서버
TypeScript로 작성된 Omnisend API V5와 통합된 MCP(Model Context Protocol) 서버입니다.
버전: 2.2.0
특징
- 연락처 관리(목록, 생성, 가져오기, 업데이트)
- 제품 관리(목록, 생성, 가져오기, 바꾸기, 삭제)
- 이벤트 추적
- 제품 카테고리 관리
- 다음/이전 URL 및 제한/오프셋 정보를 제공하는 커서 기반 페이지 매김 지원
버전 2.2.0의 변경 사항
- 더욱 모듈화된 구조로 코드베이스를 리팩토링했습니다.
- 도메인별 모듈(연락처, 제품, 카테고리, 이벤트) 구현
- 논리적 디렉토리(/types, /filters, /api-resources, /resources, /tools)로 구성된 코드
- ping 도구에서 서버 버전을 동적으로 만들었습니다.
- API 요청에서 더 나은 오류 처리 기능이 추가되었습니다.
- 배럴 내보내기로 향상된 코드 유지 관리
- 중복되고 불필요한 코드를 제거했습니다.
버전 2.1.0의 변경 사항
- @modelcontextprotocol/sdk v1.11.0으로 업데이트되었습니다.
- 애플리케이션 전체에서 오류 처리가 개선되었습니다.
- 더 나은 오류 메시지로 API 안정성이 향상되었습니다.
- 연결이 끊어지는 것을 방지하기 위해 요청 시간 초과 구성이 추가되었습니다.
- MCP Inspector와 SSE 연결 문제가 해결되었습니다.
- MCP 클라이언트와 호환되도록 최적화된 콘솔 출력
- MCP 응답에 커서 기반 페이지 매김 컨텍스트 추가(다음/이전 URL, 제한/오프셋)
버전 2.0.0의 변경 사항
- 전체 코드베이스를 TypeScript로 마이그레이션했습니다.
- 최신 사양에 따라 업데이트된 MCP 리소스 구조
- 모든 API 응답 및 요청에 대해 적절한 유형 선언이 추가되었습니다.
- 유형화된 예외로 오류 처리가 개선되었습니다.
- 향상된 코드 구성 및 유지 관리
설치
지엑스피1
건물
TypeScript 코드를 컴파일하려면:
개발 모드에서 실행
자동 재로딩을 이용한 개발의 경우:
구성
Omnisend API 키로 루트 디렉토리에 .env 파일을 만듭니다.
OMNISEND_API_KEY=your_api_key_here
OMNISEND_API_URL=https://api.omnisend.com/v5
용법
MCP 서버를 시작하려면:
MCP 서버와 상호 작용
MCP 서버는 모델 컨텍스트 프로토콜(MCP)을 이해하는 클라이언트와 함께 사용하도록 설계되었습니다. MCP 서버와 상호 작용하는 방법은 다음과 같습니다.
VS 코드 통합
VS Code와 함께 사용할 수 있도록 .vscode/mcp.json 파일에 구성 파일이 제공됩니다. 적절한 MCP 확장명을 사용하는 VS Code는 이 서버와 통신할 수 있습니다.
AI 어시스턴트
MCP를 지원하는 Claude와 같은 AI 보조원은 이 서버와 통신하여 Omnisend 데이터에 액세스하고 작업을 수행할 수 있습니다.
Claude Desktop과 함께 사용
Claude Desktop과 함께 이 MCP 서버를 사용하려면:
- 공식 웹사이트 에서 Claude Desktop을 다운로드하여 설치하세요.
- 시스템에 Node.js가 설치되어 있는지 확인하세요. 다음을 실행하여 확인할 수 있습니다.Node.js가 설치되어 있지 않으면 nodejs.org 에서 다운로드하세요.
- 컴퓨터에서 Claude 메뉴를 열고 "설정..."을 선택하세요.
- 설정 창의 왼쪽 막대에서 "개발자"를 클릭한 다음 "구성 편집"을 클릭합니다.
- Claude Desktop 구성 파일이 열립니다. 파일 내용을 다음 구성으로 바꾸거나 추가하세요.
{
"mcpServers": {
"omnisend": {
"command": "node",
"args": [
"/path/to/dist/index.js"
],
"env": {
"OMNISEND_API_KEY": "your_api_key_here"
}
}
}
}
your_api_key_here 실제 Omnisend API 키로 바꿔야 합니다. - 구성 파일을 저장하고 Claude Desktop을 다시 시작합니다.
- 재시작 후 입력 상자의 오른쪽 하단에 망치 아이콘이 표시됩니다.
- 사용 가능한 Omnisend 도구를 보려면 망치 아이콘을 클릭하세요.
- 이제 Claude에게 다음과 같은 작업을 수행하도록 요청할 수 있습니다.
- "Omnisend에서 최근 연락처 나열"
- "Omnisend 카탈로그에 새 제품을 만들어 보세요"
- "Omnisend에 고객 이벤트 보내기"
맞춤형 MCP 클라이언트
@modelcontextprotocol/sdk 라이브러리를 사용하여 사용자 정의 클라이언트를 개발할 수 있습니다.
import { McpClient } from '@modelcontextprotocol/sdk/client/mcp';
import { ProcessClientTransport } from '@modelcontextprotocol/sdk/client/process';
const transport = new ProcessClientTransport(serverProcess);
const client = new McpClient(transport);
// Connect to the server
await client.connect();
// Execute tools
const result = await client.executeTool("listContacts", { limit: 10 });
API 문서
Omnisend API에 대한 자세한 내용은 공식 문서를 참조하세요.
특허
이 프로젝트는 Apache License 2.0에 따라 라이선스가 부여되었습니다. 자세한 내용은 LICENSE 파일을 참조하세요.