DuetFlow에는 선택해서 쓸 수 있는 내장 MCP 서버가 있어요. MCP를 쓰면 호환되는 AI 클라이언트가 DuetFlow의 기존 규칙에 따라 내가 허용한 할 일을 다룰 수 있습니다. 비공개 할 일과 공유 할 일 모두 같은 권한, 종속 관계, 반복 동작을 그대로 유지해요.
연결은 이미 쓰고 있는 Mac 앱 안에서 이루어져요. 별도의 도우미 앱도, 터미널 런타임도, 호스팅 계정도, 외부 로그인 서비스도 필요 없습니다.
DuetFlow는 아직 일반에 공개되지 않았어요. 프라이빗 베타와 출시 소식을 받으려면 사전 신청을 해 주세요. 이 안내는 설정에 AI 연동 항목이 있는 Mac 빌드에 해당해요.
데스크톱 클라이언트 연결하기
- DuetFlow → 설정 → 일반을 열고 고급 기능 표시를 켭니다.
- DuetFlow → 설정 → AI 연동을 엽니다. 작업을 수행할 구성원과 권한을 고르세요. 가구 접근을 허용한다면 가구도 선택하세요.
- 로컬 MCP 사용을 켜고 준비됨이 표시될 때까지 기다리세요.
- Codex 데스크톱 클라이언트에서 설정 → 플러그인 → 추가 → MCP 서버 추가를 엽니다. Streamable HTTP를 고르고 DuetFlow에서 복사한 MCP URL을 입력하세요.
- Authorization 헤더를 추가합니다. 값은
Bearer뒤에 공백 한 칸을 두고 DuetFlow에서 복사한 액세스 키를 붙인 것이에요. 이 헤더를 쓸 때는 베어러 토큰 환경 변수 입력란을 비워 두세요. - 연결을 저장하고 새 채팅을 시작한 뒤, DuetFlow 연결을 확인해 달라고 요청해 보세요.
액세스 키는 신뢰할 수 있는 클라이언트의 연결 설정에만 붙여 넣으세요. 키와 복사한 설정은 비공개로 유지하고, 채팅이나 지원 문의 메시지에는 절대 붙여 넣지 마세요.
설정 파일이나 다른 MCP 클라이언트 쓰기
Codex라면 DuetFlow에서 Codex 설정 복사를 선택하고, 해당 섹션을 ~/.codex/config.toml에 추가하세요. DuetFlow 섹션이 이미 있다면 중복해서 추가하지 말고 교체한 뒤, 다시 연결하고 새 채팅을 시작합니다. 프로젝트 로컬 설정은 인식되고 신뢰할 수 있는 프로젝트가 있어야 하며, 프로젝트 없는 채팅에 두루 쓰는 설정 방법은 아니에요.
다른 클라이언트는 로컬 Streamable HTTP와 사용자 지정 Authorization: Bearer 헤더를 지원해야 해요. DuetFlow에서 URL과 액세스 키를 복사해 해당 클라이언트의 연결 설정에 넣으세요.
어시스턴트가 접근할 수 있는 범위 정하기
비공개 영역과 가구 영역의 읽기/쓰기 권한은 서로 독립적이에요. 첨부 파일 전송과 관리 기능에도 각각 별도의 권한이 있습니다. 영향이 큰 작업은 DuetFlow에 정확한 미리보기가 열리고, 거기서 변경을 승인해요. 어시스턴트가 대신 승인할 수는 없습니다.
이렇게 요청해 보세요
- “내 비공개 인박스에 ‘정비소에 전화하기’를 담아 줘.”
- “열려 있는 프로젝트를 훑어보고, 다음 행동이 없는 것을 알려 줘.”
- “Erfasse ‘Werkstatt anrufen’ in meiner privaten Inbox.”
이 서버는 Getting Things Done 맥락을 제공하고, 시작 연기일, 계획일, 마감일을 서로 구분해서 다루며, 담당 지정, 상속, 반복에 관한 DuetFlow의 기존 규칙을 그대로 따릅니다.
호환성과 사용 가능 여부
Mac을 깨어 있는 상태로 두고 DuetFlow를 실행해 두세요. DuetFlow를 종료하면 서버도 멈춰요. 호스팅되는 일반 ChatGPT 웹과 iPhone 채팅은 이 Mac 로컬 엔드포인트에 직접 연결할 수 없습니다. 데스크톱 클라이언트가 로컬 HTTP MCP를 실제로 지원해야 하며, 데스크톱 채팅 앱을 설치했다는 것만으로는 지원이 보장되지 않아요. STDIO만 지원하는 클라이언트는 어댑터가 필요하며, 이 직접 연결에서는 지원하지 않습니다.
이것은 로컬 연동이며, 공식 ChatGPT 공개 플러그인이나 디렉터리 등록은 없습니다. 클라이언트나 계정 정책에 따라 MCP 접근이 제한될 수 있어요. 연결된 구성원, 권한, 연결 상태를 확인하려면 get_profile과 connection_status를 읽어 보세요.
도구가 보이지 않거나 서버 URL을 바꿨다면 새 채팅을 시작하세요. 저희 데스크톱 테스트에서는 설정을 바꾼 뒤에도 기존 채팅이 이전 도구나 주소를 그대로 유지했어요. 일반 DuetFlow 앱은 설정해 둔 포트를 그대로 유지합니다.
접근 중단하기 또는 키 바꾸기
로컬 MCP 사용을 끄면 접근이 바로 중단돼요. 구성원, 가구, 권한을 바꾸기 전에는 먼저 끄세요. 액세스 키 다시 만들기를 하면 이전 키는 무효가 되니, 새 정보를 복사해 클라이언트를 다시 연결하세요. 포트가 사용 중이라면 접근을 끄고, 고급 설정에서 사용 가능한 포트를 고른 다음, 다시 켠 뒤 클라이언트 URL을 업데이트하세요.
응답이 실패한 뒤에는 다시 시도하기 전에 작업 상태를 확인하세요. 로컬에 저장된 영수증이 있다고 해서 iCloud 동기화가 끝났다는 뜻은 아니에요. 가져오기, 백업, 복원, 공유, 시스템 권한은 각각 기본 제공 보호 장치를 그대로 유지합니다.