클로드스킬마트스킬 둘러보기스킬이 뭐예요?
 
← 목록으로

Microsoft Teams 채널 연동 (add-teams)

NanoClaw 봇을 Microsoft Teams 채널·그룹채팅·DM에 연결하는 전 과정을 자동화하는 설치 스킬입니다.

자동화·워크플로고급★ 30,471⑂ 12,865AI 점수 7/10마지막 업데이트: 2026. 8. 9.

무엇을 해주나

NanoClaw 프로젝트에 Microsoft Teams 채널 어댑터를 추가합니다. channels 브랜치에서 Teams 어댑터 코드와 등록 테스트를 복사해 오고, 채널 배럴에 자동 등록 import를 추가하며, @chat-adapter/teams 패키지를 정확한 버전으로 고정 설치한 뒤 빌드와 통합 테스트까지 실행합니다.

자격증명 단계에서는 Microsoft Teams CLI를 전역 설치해 Microsoft 365 로그인 → Entra 앱 등록 → 클라이언트 시크릿 생성 → Teams 관리형 봇 등록 → 앱 패키지 업로드 → 설치 링크 발급을 한 번에 처리합니다(Azure 구독 불필요). 생성된 값은 .env에 안전하게 기록되고, 봇↔소유자 1:1 대화를 미리 만들어 어시스턴트가 먼저 인사 메시지를 보낼 수 있게 배선합니다.

모든 지시문은 idempotent(재실행 안전)하며, Developer Portal이 막힌 테넌트를 위한 Azure 포털 수동 경로와 상세 트러블슈팅까지 포함합니다.

이런 분께 추천

  • NanoClaw를 셀프호스팅하며 사내 Teams에서 AI 어시스턴트를 쓰고 싶은 분
  • Azure 포털 7단계 수작업 없이 CLI 한 번으로 Teams 봇을 만들고 싶은 분
  • Microsoft 365 Business/EDU/개발자 테넌트와 Cloudflare Tunnel 같은 HTTPS 공개 URL을 준비할 수 있는 분

무료 개인용 Teams 계정은 커스텀 앱 사이드로딩이 불가해 사용할 수 없습니다.

활용 예시

  1. 사내 팀 채널 어시스턴트: 팀 채널에 봇을 설치하고 @멘션으로 질문하면 스레드로 답변. RSC 권한을 추가하면 멘션 없이 모든 채널 메시지를 수신하도록 확장할 수 있습니다.
  2. 개인 DM 비서: 설치 직후 봇이 소유자 DM으로 먼저 말을 걸어, 별도 초기화 없이 바로 대화형 비서로 사용.
  3. 터널 주소 변경 대응: Cloudflare Tunnel URL이 바뀌었을 때 teams app update <app-id> --endpoint ... 한 줄로 메시징 엔드포인트만 갱신(스킬 재실행 불필요).

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 nanocoai/nanoclaw 의 .claude/skills/add-teams 폴더를 내 ~/.claude/skills/add-teams/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/nanocoai/nanoclaw.git && mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-teams ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 열고 NanoClaw 저장소를 클론합니다: git clone https://github.com/nanocoai/nanoclaw.git
  2. 스킬 디렉터리를 만듭니다: mkdir -p ~/.claude/skills
  3. 스킬을 복사합니다: cp -r nanoclaw/.claude/skills/add-teams ~/.claude/skills/
    • 이미 NanoClaw를 클론해 사용 중이라면 저장소 안의 스킬이 그대로 인식되므로 복사 없이도 됩니다.
  4. 사전 준비: Microsoft 365 Business/EDU/개발자 테넌트 계정(커스텀 앱 업로드 권한 필요)과 Node.js/npm, pnpm을 준비합니다.
  5. HTTPS 터널을 먼저 띄웁니다: cloudflared tunnel --url http://localhost:3000 — 출력된 https://... 주소를 복사해 둡니다.
  6. NanoClaw 저장소 루트에서 Claude Code를 실행하고 "add-teams 스킬로 Teams 채널을 추가해줘"라고 요청합니다(또는 /setup 흐름 중 Teams 선택).
  7. 안내에 따라 터널 URL과 봇 이름을 입력하고, 브라우저(또는 device code)로 Microsoft 365에 로그인합니다.
  8. 출력된 설치 링크를 열어 Teams에 앱을 추가한 뒤, 서비스가 재시작되면 봇이 보낸 첫 DM을 확인합니다.
  9. 문제가 생기면 SKILL.md의 Troubleshooting 섹션(사이드로딩 차단, AUTH_REQUIRED, 401 오류 등)을 참고하세요.
GitHub에서 원본 보기 ↗라이선스: MIT