Cripto Norte — Telegram MCP 서버

post_to_telegram_channel 하나의 도구를 갖춘 원격 MCP 서버로, Claude가 완성된 포스트를 Telegram 채널에 게시할 수 있게 해 줍니다. 로컬에서 엔드투엔드로 테스트했습니다(MCP 핸드셰이크, 도구 목록 확인, 도구 호출, 오류 처리) — 배포 준비가 끝났습니다.

1. Telegram 봇 만들기

1. Telegram에서 @BotFather를 열고 → /newbot → 안내를 따릅니다.

2. 봇이 알려주는 토큰(TELEGRAM_BOT_TOKEN)을 복사해 둡니다.

3. 봇을 채널에 관리자로 추가하고, 메시지 게시 권한을 부여합니다.

4. TELEGRAM_CHAT_ID는 채널의 @username(공개 채널인 경우) 또는 채널의 숫자 ID(비공개인 경우 — 채널 메시지를 @userinfobot 등으로 전달하면 알 수 있습니다)입니다.

Related MCP server: Telegram Bot MCP Server

2. 서버 배포

공개 HTTPS URL을 제공하는 Node.js 호스트라면 무엇이든 동작합니다. 가장 쉬운 옵션:

Railway / Render(무료 티어로 충분)

1. 이 폴더를 새 GitHub 저장소에 푸시합니다.

2. Railway 또는 Render에 새 Web Service를 만들고 해당 저장소를 지정합니다.

3. 호스트 대시보드에서 .env.example의 환경 변수(실제 값)를 설정합니다.

4. 빌드 명령: npm install. 시작 명령: npm start.

5. 배포가 끝나면 공개 URL(예: https://your-app.up.railway.app)을 기록해 둡니다. MCP 엔드포인트는 https://your-app.up.railway.app/mcp입니다.

Fly.io / VPS도 가능합니다 — 동일한 환경 변수, 동일한 npm start를 사용하고, 포트 3000(또는 설정한 PORT)만 HTTPS로 노출하면 됩니다.

로컬에서는 npm install && npm start를 실행하면 테스트용으로 http://localhost:3000/mcp에서 실행됩니다.

3. Claude에 연결

1. Claude에서: Customize → Connectors → + → Add custom connector를 선택합니다.

2. 이름: Cripto Norte Telegram.

3. URL: https://your-app.up.railway.app/mcp.

4. 고급 설정: 이 서버는 완전한 OAuth 대신 단순 Bearer 토큰(MCP_AUTH_TOKEN)을 확인합니다. 따라서 현재 자기 Claude 플랜의 사용자 지정 커넥터 UI에서 정적 bearer 토큰을 제공하는 옵션을 선택하세요. 이 부분은 최근에 변경되었으므로 해당 옵션이 보이지 않으면 support.claude.com에서 현재 필드 이름을 확인하거나, 첫 개인 테스트에서는 MCP_AUTH_TOKEN 확인을 아예 끄는 것도 방법입니다.

5. Add를 클릭한 다음 Connect를 클릭합니다.

6. 채팅에서 + → Connectors를 클릭하고 해당 대화에서 이 커넥터를 활성화합니다.

4. 테스트

해당 대화에서 Claude에게 "커넥터로 Telegram 채널에 테스트 메시지를 보내 줘"라고 요청해 보세요. Claude가 post_to_telegram_channel을 호출하고, 채널에 메시지가 도착하는 것을 확인할 수 있습니다.

5. 예약 작업에 연결

Claude Cowork → Scheduled → New task → Set up manually:

• 작업에서 Cripto Norte Telegram 커넥터를 활성화합니다.

• 프롬프트: cripto-norte-posts 스킬, 포스트 유형(UTRNNIK / digest), 최신 가격·뉴스를 가져올 출처를 언급하고, 완성된 형식의 텍스트로 post_to_telegram_channel을 호출하라는 명시적인 지시를 포함해야 합니다.

• 주기(예: 매일 08:30 및 19:00 로컬 시간)를 설정합니다.

• 승인 모드는 "확인 필요"로 시작하고, 몇 차례 실행을 확인한 뒤 자동 모드로 전환합니다.

참고 사항

• 서버는 세션을 메모리에 유지합니다. 서버가 재시작되면 Claude가 다음 호출에서 다시 초기화할 뿐입니다. 별도 조치는 필요 없습니다.

• 전송 시 parse_mode: "Markdown"을 사용하며, 이는 MoMint의 포맷 규칙(고정폭 제목, 굵은 수치, 헤더에만 em dash)과 일치합니다.

• 도구가 더 필요해지면(예: 여러 채널에 게시하거나 코인별 전용 도구), index.js에 동일한 패턴으로 server.registerTool(...) 블록을 추가하면 됩니다.