외부 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를 사용합니다.

https://api.marcvs745.com/mcp

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

Codex에 직접 연결하기

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

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

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

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

Codex 공식 MCP 안내

ChatGPT의 수동 연결 절차

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

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

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

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

ChatGPT 공식 직접 연결 안내

Claude의 수동 연결 절차

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

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

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

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

Claude 공식 원격 MCP 안내

Gemini의 수동 연결 절차

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

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

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

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

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

Gemini 공식 사용자 지정 앱 안내

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

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

요청 예시:

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

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

연결이 되지 않을 때

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