본문으로 건너뛰기
OneCanvas

Codex 앱으로 연결하기

요청은 Codex에서,
결과는 내 캔버스에.

Codex에 OneCanvas를 한 번 연결하세요. 메모를 만들고 자료를 정리한 결과를 브라우저의 개인 캔버스에서 확인할 수 있습니다.

Codex에서 요청OneCanvas에 반영캔버스에서 확인

Windows와 Mac의 Codex 앱에서 설정합니다. OneCanvas 전용 연결 앱은 필요하지 않습니다.

  1. Codex 앱에 서버 주소 추가

    설정(Settings) → MCP servers → Add server를 여세요. 연결 방식은 Streamable HTTP를 선택하고 아래 내용을 입력하세요.

    이름 / Nameonecanvas-workspace
    서버 주소 / URLhttps://onecanvas-team.riana.chatgpt.site/api/mcp/transport

    저장(Save)한 뒤 Restart가 표시되면 눌러 설정을 적용하세요. API 키와 별도 인증 헤더는 입력하지 않습니다.

  2. OneCanvas 계정 연결 허용

    추가한 서버에서 Authenticate(인증)를 누르세요. 열린 브라우저에서 OneCanvas에 로그인하고, 접근 권한을 확인한 뒤 연결을 허용하세요.

    승인 완료 화면에 Codex로 돌아가는 버튼이 보이면 눌러 주세요. ChatGPT 로그인은 Codex 이용을 위한 것이고, 이 승인은 내 OneCanvas 자료에 접근하기 위한 것입니다.

  3. 새 Codex 대화에서 첫 메모 만들기

    아래 요청을 Codex에 보내세요. 실행하면 개인 캔버스에 메모 카드 하나를 추가하고 열 수 있는 링크를 알려줍니다.

    OneCanvas에서 첫 작업을 해볼게. onecanvas_project_read로 내 캔버스를 확인한 뒤, 기존 카드는 변경하거나 삭제하지 말고 '첫 Codex 연결'이라는 메모 카드 하나를 새로 만들어줘. 내용은 'Codex와 OneCanvas 연결 완료. 이제 회의 내용과 할 일을 이곳에 정리할 수 있어요.'로 넣고, 마지막에 내 캔버스를 열 수 있는 링크를 알려줘.

    이 페이지의 상태 확인을 기다릴 필요는 없습니다. Codex가 작업 승인을 요청하면 내용을 확인하고 진행하세요.

    다음: 실제로 사용하는 방법 →
연결 상태는 로그인 후 확인할 수 있습니다.

계정 승인과 첫 통신은 따로 확인됩니다. 카드 생성 결과는 실제 캔버스에서 확인하세요.

로그인하기

연결 중 막혔나요?

MCP servers 메뉴가 보이지 않아요

ChatGPT 웹페이지가 아닌 Codex 앱의 설정을 열었는지 확인하세요. 앱 버전에 따라 메뉴 위치와 번역이 다를 수 있습니다. 앱을 업데이트한 뒤 공식 MCP 설정 안내를 확인해 주세요.

공식 MCP 설정 안내 ↗
OneCanvas 도구가 없다고 해요

서버가 켜져 있는지, Authenticate 승인이 끝났는지 확인하세요. 설정을 적용한 뒤 새 대화를 시작하고, 입력창에 /mcp를 입력하면 연결된 서버를 볼 수 있습니다. 회사 계정이라면 관리자의 외부 도구 허용이 필요할 수 있습니다.

127.0.0.1 연결 오류가 보여요

서버 URL에는 위의 HTTPS 주소를 입력하세요. 이전 OneCanvas 연결 앱이나 로컬 브리지 주소는 이 설정에서 사용하지 않습니다.

계정 승인 직후 localhost 오류가 나왔다면 Codex 앱을 켜 둔 채 같은 PC의 브라우저에서 다시 Authenticate를 진행하세요. 다른 PC나 원격 브라우저에서 승인하면 Codex로 돌아가지 못할 수 있습니다.

만든 카드가 지금 보는 캔버스에 없어요

Codex가 반환한 캔버스 링크를 여세요. 연결은 승인한 계정의 개인 캔버스를 대상으로 합니다. 공개 시연이나 임시 체험 공간, 다른 계정의 캔버스와는 다릅니다.

OneCanvas는 현재 플러그인 목록에서 검색해 설치할 수 없습니다. 위의 서버 주소를 추가해 연결해 주세요.

연결 관리

OneCanvas에 로그인하면 승인한 연결을 확인하고 해제할 수 있습니다. 로그인하기