SendGrid MCP Server

AI 어시스턴트가 SendGrid의 Web API v3를 통해 이메일을 보내고 연락처를 관리할 수 있게 해주는 Python MCP(Model Context Protocol) 서버입니다.

도구

설정

1. 가상 환경을 만들고 종속성을 설치합니다:

   python -m venv venv
   source venv/bin/activate   # Windows: venv\Scripts\activate
   pip install -r requirements.txt

2. .env.example을 .env로 복사하고 SendGrid API 키(SendGrid 대시보드의 Settings > API Keys)와 기본 발신자를 입력합니다:

   cp .env.example .env

3. 전송 전에 SendGrid의 Settings > Sender Authentication에서 발신자 이메일을 인증하세요 -- 인증되지 않은 발신자는 거부됩니다.

4. (선택 사항) Email API > Dynamic Templates에서 동적 템플릿을 만들고 .env에 DEFAULT_TEMPLATE_ID를 설정합니다.

실행

python main.py

이 명령은 Claude Desktop과 같은 MCP 클라이언트가 로컬 하위 프로세스에 대해 기대하는 전송 방식인 stdio를 통해 서버를 실행합니다.

작동 확인

python smoke_test.py

등록된 도구를 나열하고 SendGrid 계정에 대해 실시간 호출을 한 번 수행합니다. 대화형 스키마/도구 검사를 위해서는:

npx @modelcontextprotocol/inspector python main.py

Claude Desktop에 연결

claude_desktop_config.json에 추가합니다:

{
  "mcpServers": {
    "sendgrid-mcp": {
      "command": "python",
      "args": ["/path/to/twilio-sendgrid-mcp/main.py"],
      "cwd": "/path/to/twilio-sendgrid-mcp",
      "env": {
        "SENDGRID_API_KEY": "SG.your-actual-api-key-here"
      }
    }
  }
}

그 후 Claude Desktop을 다시 시작합니다. 도구 호출이 실패하면 ~/Library/Logs/Claude/mcp*.log(macOS)에서 서버의 stderr 출력을 확인합니다.