ChatGPT 연동

ChatGPT의 Developer Mode를 통해 NLook MCP 서버에 연결하여 대화형으로 문서와 할일을 관리할 수 있습니다.

사전 준비

지원 플랜

ChatGPT Developer Mode는 다음 플랜에서 사용 가능합니다:

플랜
지원 여부

ChatGPT Free

❌

ChatGPT Plus

✅

ChatGPT Pro

✅

ChatGPT Team

✅

ChatGPT Enterprise

✅

ChatGPT Edu

✅

💡 참고: Free 플랜은 MCP 연동을 지원하지 않습니다. Plus 이상 플랜이 필요합니다.

NLook API Key 발급

  1. NLook 설정 페이지로 이동

  2. API Key 관리 섹션에서 새 API Key 생성 클릭

  3. 이름 입력: ChatGPT MCP

  4. 권한 선택:

    • 읽기: 문서/할일 조회

    • 쓰기: 문서/할일 생성/수정

    • 삭제: 문서/할일 삭제

  5. 생성 버튼 클릭

  6. API Key 복사 후 안전하게 보관

⚠️ 주의: API Key는 생성 시 한 번만 표시됩니다.

API 인증 방식

NLook API는 두 가지 인증 방식을 지원합니다:

방식
헤더
권장

X-API-Key

X-API-Key: your-api-key

✅ 권장

Bearer Token

Authorization: Bearer your-api-key

지원

💡 참고: ChatGPT Developer Mode에서 Remote Server로 연결 시, API Key 입력 프롬프트에서 키를 입력하면 자동으로 인증됩니다.

Developer Mode 활성화

Step 1: 설정 접근

  1. ChatGPT에 로그인

  2. 좌측 하단 프로필 클릭

  3. Settings 선택

Step 2: Developer Mode 켜기

  1. Apps & Connectors 탭 이동

  2. Advanced settings 클릭

  3. Developer Mode 토글 활성화

활성화되면 Create 버튼이 나타납니다.

NLook 연결하기

방법 1: Remote Server (권장)

별도 설정 없이 NLook 공개 서버에 바로 연결합니다.

  1. Settings → Apps & Connectors → Create 클릭

  2. 정보 입력:

    • Connector name: NLook

    • Description: NLook 문서 및 할일 관리

    • Connector URL: https://nlook.me/mcp

  3. Create 클릭

  4. API Key 입력 (인증 요청 시)

방법 2: Local Server

로컬에서 MCP 서버를 실행하고 싶은 경우:

1. 서버 실행

# 설치
npm install -g nlook-mcp

# 실행
NLOOK_API_KEY=your-api-key npx nlook-mcp --http

2. HTTPS 터널 설정

ChatGPT는 HTTPS만 지원합니다.

# ngrok 사용
ngrok http 3000

# 출력 예시: https://abc123.ngrok.app

3. ChatGPT에 연결

  • Connector URL: https://abc123.ngrok.app/mcp

사용 방법

대화에서 NLook 활성화

  1. 새 대화 시작

  2. 메시지 입력창 옆 + 버튼 클릭

  3. More → NLook 선택

문서 관리 예시

문서 저장

오늘 회의 내용을 NLook에 저장해줘:

# 주간 회의록
- 참석자: 김철수, 이영희
- 논의 사항: 프로젝트 일정 조정
- 결론: 다음 주 금요일까지 완료

문서 조회

NLook에서 최근 문서 5개 보여줘
NLook에서 "회의록" 검색해줘

문서 수정

NLook 문서 123번 제목을 "12월 회의록"으로 변경해줘

할일 관리 예시

할일 생성

NLook에 할일 추가:
- 제목: 보고서 작성
- 우선순위: 높음
- 마감일: 이번 주 금요일

할일 조회

NLook에서 완료 안 된 할일 보여줘
NLook에서 높은 우선순위 할일만 보여줘

할일 완료

NLook 할일 456번 완료 처리해줘

사용 가능한 도구

문서 도구

도구
설명
필수 파라미터

create_document

문서 생성

title, content

list_documents

문서 목록

-

get_document

문서 상세

id

update_document

문서 수정

id

delete_document

문서 삭제

id

할일 도구

도구
설명
필수 파라미터

create_task

할일 생성

title

list_tasks

할일 목록

-

update_task

할일 수정

id

complete_task

할일 완료

id

delete_task

할일 삭제

id

할일 목록 도구

도구
설명
필수 파라미터

list_task_lists

목록 그룹 조회

-

create_task_list

목록 생성

name

Deep Research 모드

ChatGPT Deep Research에서도 NLook을 활용할 수 있습니다.

NLook에 저장된 프로젝트 문서들을 분석해서 진행 상황 요약해줘

참고: Deep Research는 search와 fetch 도구만 사용하므로 조회 기능에 최적화되어 있습니다.

쓰기 작업 승인

보안을 위해 쓰기 작업은 사용자 확인이 필요합니다:

  1. ChatGPT가 도구 호출 내용을 표시

  2. 내용 확인 후 Approve 클릭

  3. 작업 실행

대화 중 승인을 기억하도록 설정할 수도 있습니다.

문제 해결

"Connection failed" 오류

  • MCP 서버 URL이 HTTPS인지 확인

  • 서버가 실행 중인지 확인

  • 방화벽 설정 확인

"Invalid API key" 오류

  • NLook 설정에서 API Key 상태 확인

  • API Key 재발급 후 다시 시도

도구가 보이지 않음

  • Developer Mode 활성화 확인

  • Connector 생성 여부 확인

  • 페이지 새로고침

권한 오류

  • API Key 권한 설정 확인

  • 필요한 권한이 부여되었는지 확인

관련 문서

PreviousMCP Server 연동Next자주 묻는 질문

Last updated