> ## Documentation Index
> Fetch the complete documentation index at: https://manual.voiceping.net/llms.txt
> Use this file to discover all available pages before exploring further.

# VoicePing 외부 액세스

> MCP로 VoicePing 회의록을 AI 클라이언트에 연결하거나 권한 범위가 지정된 API 키로 자체 백엔드에 연결하는 방법

export const FeedbackKo = () => <>
    <Tip>
      기능 개선 의견이나 요청은 <a href="/ko/product-feedback">Product Feedback</a>에서 보내 주세요.
    </Tip>

    <h2>공식 링크</h2>

    <CardGroup cols={2}>
      <Card title="공식 웹사이트" icon="globe" href="https://voiceping.net/en/">
        VoicePing 공식 웹사이트 열기
      </Card>
      <Card title="X (Twitter)" icon="x-twitter" href="https://x.com/VoicePingMedia">
        X에서 VoicePing 팔로우하기
      </Card>
      <Card title="Facebook" icon="facebook" href="https://www.facebook.com/voiceping.inc">
        Facebook 페이지 열기
      </Card>
      <Card title="LinkedIn" icon="linkedin" href="https://www.linkedin.com/company/28684130/">
        LinkedIn 페이지 열기
      </Card>
    </CardGroup>
  </>;

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/z13MfE0CikV5b-4X/en/images/external_access/external-access-hero-image.jpg?fit=max&auto=format&n=z13MfE0CikV5b-4X&q=85&s=bcb692bf8fd9a416331b51fbcdcdfc17" alt="MCP Access로 AI 클라이언트를, API 키로 클라우드 서비스를 VoicePing 회의록에 연결하는 구성" width="1408" height="768" data-path="en/images/external_access/external-access-hero-image.jpg" />
</Frame>

<iframe src="https://www.youtube.com/embed/ISEWqX7wFkA" width="100%" height="400" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

## 회의록을 AI 클라이언트와 자체 백엔드에 연결

회의록에는 의사결정, 문제점, 우려 사항, 기한, 약속 등 업무에 필요한 정보가 기록됩니다.

\*\*VoicePing 외부 액세스(External Access)\*\*는 이 데이터를 다른 도구에서 활용할 수 있는 두 가지 방법을 제공합니다.

* **[MCP Access](/ko/external-access/mcp)** — Claude, ChatGPT, Codex, Claude Code, Gemini CLI 등 MCP 지원 AI 클라이언트에서 회의록을 조회하고 답변, 초안, 시사점을 생성합니다.
* **[API Access](/ko/external-access/api-access)** — 권한 범위가 지정된 API 키로 백엔드에서 VoicePing API를 호출하고 회의록을 CRM, 보고 파이프라인, 대시보드, 사내 도구에 연동합니다.

두 방식 모두 \*\*워크스페이스 설정 → 외부 액세스(External Access)\*\*에서 관리하며, 같은 권한 범위, 접근 상태 관리, 이벤트 로그를 사용합니다.

***

## 용도에 맞게 선택

<CardGroup cols={2}>
  <Card title="AI 클라이언트용 MCP Access" icon="robot" href="/ko/external-access/mcp">
    MCP Access를 활성화하고 ChatGPT, Claude, Claude Code, Codex CLI, Gemini CLI를 연결하는 방법을 확인합니다.
  </Card>

  <Card title="백엔드용 API Access" icon="code" href="/ko/external-access/api-access">
    API 키를 발급하고 Bearer 토큰으로 인증한 뒤 TypeScript, Python, Java, Go에서 API를 호출합니다.
  </Card>
</CardGroup>

어느 쪽을 써야 할지 확실하지 않을 때의 간단한 규칙입니다.

```text theme={null}
사람이 질문하면 MCP Access를 사용합니다.
서버가 데이터를 가져오면 API Access를 사용합니다.
```

***

## 다섯 가지 MCP 워크플로우 예시

다음은 MCP Access를 활용하는 대표적인 워크플로우입니다. 각 페이지에서 복사해 사용할 수 있는 프롬프트와 예시 화면을 확인할 수 있습니다.

<CardGroup cols={2}>
  <Card title="고객용 회의 안건 작성" icon="list-check" href="/ko/external-access/workflow-meeting-agenda">
    고객과의 최근 3\~4회 회의에서 캘린더 초대에 바로 붙여넣을 수 있는, 시간 배분이 포함된 실용적인 회의 안건을 생성합니다.
  </Card>

  <Card title="한 번의 회의로부터 제안서 초안 작성" icon="file-signature" href="/ko/external-access/workflow-proposal">
    목표, 문제점, 우려 사항, 일정을 추출해 임원 대상 제안서 초안으로 정리합니다.
  </Card>

  <Card title="30초 만에 후속 이메일 발송" icon="paper-plane" href="/ko/external-access/workflow-follow-up-email">
    의사결정과 담당자를 정리해 전문적인 후속 이메일 초안을 작성합니다.
  </Card>

  <Card title="팀원별 KPI 추적" icon="chart-line" href="/ko/external-access/workflow-team-kpis">
    여러 팀원이 진행한 회의를 바탕으로 관리자용 KPI 비교 보고서를 작성합니다.
  </Card>

  <Card title="여러 영업 건의 병목 찾기" icon="magnifying-glass-chart" href="/ko/external-access/workflow-bottlenecks">
    반복되는 장애 요인, 담당자 부재, 보안 지연을 찾아 우선순위가 있는 실행 계획으로 정리합니다.
  </Card>
</CardGroup>

<Tip>
  **공통 흐름:** AI로 **회의록을 검색**하고, 관련 회의로 **범위를 좁힌** 뒤, 필요한 **출력 형식**(안건, 이메일, 제안서, 보고서)을 요청합니다. 다른 워크플로우에도 같은 흐름을 적용할 수 있습니다.
</Tip>

***

## 회의록 스코프

외부 액세스는 권한 범위(스코프)로 제어됩니다. 관리자는 MCP 연결이나 API 키가 수행할 수 있는 작업을 지정합니다.

| 스코프                     | 허용되는 작업               |
| ----------------------- | --------------------- |
| **transcripts.search**  | 회의록 메타데이터와 목록 검색      |
| **transcripts.read**    | 회의록 본문 읽기             |
| **transcripts.ai.read** | AI 요약 및 구조화된 AI 출력 읽기 |

API 키는 **허용된 IP 주소**로 접근을 제한해 신뢰하는 서버에서만 사용하도록 설정할 수 있습니다.

***

## 접근 상태 관리

MCP 연결과 API 키 모두에 대해 언제든 접근을 일시 중지하거나 제거할 수 있습니다.

| 동작                   | 의미                  |
| -------------------- | ------------------- |
| **비활성화(Deactivate)** | 접근을 일시적으로 차단        |
| **재활성화(Reactivate)** | 연결 또는 키가 유효하면 접근 복원 |
| **삭제(Delete)**       | 연결 또는 키를 영구 제거      |

***

## 이벤트 로그

외부 액세스와 관련된 키 생성, 연결 승인, 비활성화, 삭제, 모드 전환은 워크스페이스 이벤트 로그에 기록됩니다. 관리자는 작업 시간, 수행자, IP 주소를 확인할 수 있습니다.

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/UAFSkuYjrMFGjvGM/en/images/external_access/external_access_event_%20logs.png?fit=max&auto=format&n=UAFSkuYjrMFGjvGM&q=85&s=61bbb0c8c9acbb9315ed3135763ed42b" alt="API 키 생성과 MCP 모드 변경 등 External Access 작업이 표시된 Event Log" width="1896" height="830" data-path="en/images/external_access/external_access_event_ logs.png" />
</Frame>

***

## 워크플로우 하나로 시작하기

먼저 자주 사용하는 **한 가지 워크플로우**를 선택해 반복적으로 사용한 뒤 필요한 워크플로우를 추가하세요. 회의록을 보관하는 데 그치지 않고 실제 업무에 활용할 수 있습니다.

<CardGroup cols={2}>
  <Card title="MCP Access로 이동" icon="robot" href="/ko/external-access/mcp">
    Claude, ChatGPT, Codex, Claude Code, Gemini CLI를 연결하고 워크플로우 예시를 시작합니다.
  </Card>

  <Card title="API Access로 이동" icon="code" href="/ko/external-access/api-access">
    TypeScript, Python, Java, Go용 API 빠른 시작 안내를 확인합니다.
  </Card>
</CardGroup>

<FeedbackKo />
