---
type: guide
title: "외부 AI 서비스 연결(MCP)"
description: "Graph Card MCP를 AI 에이전트에 직접 추가하는 방법과 확인된 연결 범위."
---

# 외부 AI 서비스 연결(MCP)

지원하는 외부 AI 서비스에 Graph Card를 연결하면 대화에서 카드 초안을 만들고 수정할 수 있습니다. AI 작업은 연결한 외부 서비스에서 진행됩니다. Graph Card 멤버십이 제공하는 것은 계정 동기화와 MCP 연결 기능이며, 외부 AI 서비스의 계정·이용 요금·사용 한도는 해당 서비스의 조건을 따릅니다.

이 안내는 에이전트에 MCP 서버를 직접 추가하는 방법입니다. 공개 디렉터리에 플러그인을 출시하거나 심사받는 절차는 필요하지 않습니다. 서비스의 계정·관리자 정책에 따라 직접 연결 기능이 제한될 수 있습니다.

## 현재 확인된 연결

2026-11-08 문서 기준, Graph Card 운영 서버에서 실제 로그인을 완료하고 도구를 호출한 기록이 있는 클라이언트는 **Codex**입니다.

| 클라이언트 | 실제 확인한 범위 |
| --- | --- |
| Codex | OAuth 로그인, MCP 도구 목록, 기존 초안 목록과 내용 조회 |

새 초안의 생성·수정과 앱 반영은 아래 사용 흐름을 따르며, 위 표의 실제 확인 범위와 구분합니다. ChatGPT·Claude·Gemini의 공식 수동 MCP 설정 방법도 아래에 제공하지만, **Graph Card와의 실제 연결 검증은 아직 완료되지 않았으므로 지원 목록에 포함하지 않습니다.**

## 연결 전에 준비하기

- Graph Card 앱에서 사용하는 계정과 연결할 때 로그인하는 계정을 맞춰 주세요.
- 외부 AI 서비스가 원격 MCP와 OAuth 로그인을 지원해야 합니다.
- Graph Card는 OAuth 클라이언트를 자동 등록하지 않습니다. Codex 이외 서비스는 해당 서비스의 콜백 주소에 맞게 사전 등록된 OAuth 연결 설정이 필요합니다. Codex의 클라이언트 ID를 다른 서비스에 재사용하지 마세요.
- MCP 기능과 계정 동기화에는 멤버십 권한이 적용됩니다. 외부 AI 서비스의 유료 이용권은 별도입니다.

MCP 서버 주소는 다음과 같습니다. 연결 방식 선택 항목이 있다면 **Streamable HTTP**를 사용합니다.

```text
https://api.marcvs745.com/mcp
```

로그인은 연결 과정에서 열리는 Graph Card 인증 화면에서 진행합니다. 비밀번호나 인증 토큰을 AI 대화에 붙여넣을 필요가 없습니다.

## Codex에 직접 연결하기

Codex CLI 0.153.4에서 확인한 설정입니다. 아래 명령은 Codex가 실행되는 자신의 컴퓨터에서 실행합니다.

```sh
codex -c 'mcp_oauth_callback_url="http://127.0.0.1:8765/callback"' \
  -c 'mcp_oauth_callback_port=8765' \
  mcp add graph-card \
  --url https://api.marcvs745.com/mcp \
  --oauth-client-id memory-card-codex-cli

codex -c 'mcp_oauth_callback_url="http://127.0.0.1:8765/callback"' \
  -c 'mcp_oauth_callback_port=8765' \
  mcp login graph-card --scopes openid
```

1. 브라우저의 Graph Card 인증 화면에서 앱과 같은 계정으로 로그인합니다.
2. `codex mcp list`에서 `graph-card` 등록 상태를 확인합니다. 등록 목록에 보이는 것만으로 도구 호출이 검증되는 것은 아닙니다.
3. 연결을 읽지 못한 기존 대화라면 새 Codex 대화를 시작하고 MCP 도구 목록을 확인합니다.
4. 먼저 “Graph Card의 내 초안 목록을 조회해 줘”처럼 읽기 요청으로 연결을 확인합니다.

이미 연결되어 정상 동작하면 다시 등록할 필요가 없습니다. 8765 포트를 사용할 수 없거나 콜백 오류가 나면 포트를 임의로 바꾸지 마세요. 서버에 사전 등록된 콜백과 일치해야 합니다.

[Codex 공식 MCP 안내](https://learn.chatgpt.com/docs/extend/mcp?surface=cli)

## ChatGPT의 수동 연결 절차

아래는 플랫폼 설정 참고용입니다. 이 안내에는 ChatGPT용 Graph Card OAuth 연결 설정이 제공되지 않으므로, 현재 안내만으로 Graph Card 연결을 완료할 수는 없습니다.

**플랫폼의 MCP 직접 추가 기능은 공식 문서에서 확인했습니다. Graph Card 연결은 검증 전이며, 서비스에 맞춘 OAuth 사전 등록이 필요합니다.**

1. ChatGPT의 **Plugins**에서 `+` → **Add custom MCP server**를 엽니다. 메뉴 제공 여부는 계정과 워크스페이스 정책을 따릅니다.
2. 이름을 `Graph Card`로 정하고 위 MCP 주소를 입력합니다.
3. 인증이 필요한 서버이므로 OAuth를 설정합니다. Graph Card용으로 사전 등록된 해당 서비스의 연결 설정을 사용합니다. 인증 없음으로 바꾸어 연결하지 않습니다.
4. 로그인과 도구 목록 확인을 완료한 후 새 대화에서 연결을 선택하고 초안 목록 조회를 시도합니다.

화면에서 개인용 연결을 플러그인으로 생성하더라도 공개 디렉터리 출시와는 별개입니다. `invalid_client`나 콜백 불일치가 발생하면 Graph Card용 OAuth 등록이 먼저 필요하며, MCP 주소만 입력해서 해결되는 문제가 아닙니다.

[ChatGPT 공식 직접 연결 안내](https://developers.openai.com/plugins/deploy/connect-chatgpt)

## Claude의 수동 연결 절차

아래는 플랫폼 설정 참고용입니다. 이 안내에는 Claude용 Graph Card OAuth 연결 설정이 제공되지 않으므로, 현재 안내만으로 Graph Card 연결을 완료할 수는 없습니다.

**Claude는 원격 MCP 사용자 지정 커넥터를 제공합니다. Graph Card 연결은 검증 전이며, 서비스에 맞춘 OAuth 사전 등록이 필요합니다.**

1. Claude의 **Customize → Connectors**에서 사용자 지정 웹 커넥터 추가를 엽니다.
2. 이름 `Graph Card`와 위 MCP 주소를 입력합니다.
3. 인증 설정에서 로그인 방식을 선택하고, 사전 등록된 OAuth 연결 설정이 제공된 경우 **Use your own OAuth client**를 사용합니다. Graph Card는 자동 클라이언트 등록을 제공하지 않습니다.
4. Graph Card 계정으로 로그인한 뒤 대화에서 해당 커넥터를 켜고 초안 목록 조회를 시도합니다.

조직 계정은 관리자가 커넥터를 먼저 추가해야 할 수 있습니다. 원격 커넥터는 Claude 서비스에서 서버에 접속하므로 로컬 데스크톱 MCP 설정과 구분합니다.

[Claude 공식 원격 MCP 안내](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)

## Gemini의 수동 연결 절차

아래는 플랫폼 설정 참고용입니다. 이 안내에는 Gemini용 Graph Card OAuth 연결 설정이 제공되지 않으므로, 현재 안내만으로 Graph Card 연결을 완료할 수는 없습니다.

**Gemini 앱의 사용자 지정 MCP 연결 기능은 공식 문서에서 확인했습니다. Graph Card 연결은 검증 전입니다.**

현재 Google 안내의 조건은 **미국의 만 18세 이상 개인 Google 계정, 영어, Keep Activity 켜짐**입니다. 직장·학교 계정에는 제공되지 않습니다. 한국·일본·대만에서 같은 메뉴를 사용할 수 있다고 안내하지 않습니다. Gemini CLI와 Gemini 앱은 서로 다른 제품이며, 이 절차는 Gemini 웹 앱 기준입니다.

1. 조건을 충족한 계정으로 Gemini 웹 앱의 **Settings → Connected Apps**를 엽니다.
2. **Custom apps**에서 위 MCP 서버 주소를 추가합니다.
3. 자동 등록을 지원하지 않는 서버이므로 **Advanced features**에서 사전 등록된 해당 서비스의 OAuth 연결 설정을 입력합니다.
4. Graph Card 계정 로그인과 연결을 마친 후 대화의 `@` 메뉴에서 연결을 선택하고 초안 목록 조회를 시도합니다.

추가는 웹에서 진행하며, Google의 지원 조건에 맞는 연결은 Gemini 웹·모바일에서 사용할 수 있습니다. 기능과 제공 지역은 Google의 최신 안내를 확인하세요.

[Gemini 공식 사용자 지정 앱 안내](https://support.google.com/gemini/answer/17209137?co=GENIE.Platform%3DDesktop&hl=en-PR)

## 연결 후 카드 초안을 사용하는 흐름

1. 외부 AI 서비스에 학습 주제와 카드에 담을 범위를 설명합니다.
2. AI가 제안한 카드 내용과 관계를 먼저 확인합니다. 저장을 원하면 그 제안을 초안으로 저장하도록 명시적으로 요청합니다.
3. Graph Card 앱에서 같은 계정으로 로그인하고 계정의 초안을 엽니다.
4. 내용을 검토하고 수락해 기기의 컬렉션으로 반영합니다. 공개 발행은 별도의 앱 승인이 필요합니다.

요청 예시:

```text
Graph Card에 넣을 평균·분산·표준편차 카드 초안을 제안해 줘.
먼저 내용과 관계를 보여 주고, 내가 저장을 승인할 때까지 저장하지 마.
```

MCP 연결은 AI 설명의 정확성을 보증하지 않습니다. 원본 대화·프롬프트 전체·추론·학습 기록은 Graph Card MCP의 저장 대상이 아니며, 저장을 승인한 카드 초안 내용을 다룹니다.

## 연결이 되지 않을 때

- 연결 메뉴가 없다면 AI 서비스의 계정·지역·언어·조직 정책을 확인합니다.
- `invalid_client`·콜백 불일치는 사전 등록된 OAuth 설정이 해당 서비스와 맞는지 확인해야 합니다. 다른 서비스의 설정이나 토큰으로 우회하지 않습니다.
- 로그인은 됐지만 앱에 초안이 없다면 양쪽 Graph Card 계정이 같은지, 아직 제안만 했고 저장은 승인하지 않았는지 확인합니다.
- MCP를 연결하지 않고 컬렉션을 만들려면 [파일을 이용한 에이전트 제작 안내](/ko/docs/create/agent/)를 사용할 수 있습니다. JSON 파일 제작·가져오기는 MCP 연결과 별개의 흐름입니다.