MCP 연동

Claude Code, Codex, ChatGPT, Cursor, Claude Desktop 등의 AI를 Addness에 연결(MCP 연동)하면, AI가 Addness의 목표·ToDo·댓글 등을 읽고 쓸 수 있게 됩니다.

처음이신 분께: 조직을 새로 만든 사람과, 초대받아 조직에 들어온 사람의 목표 페이지에는 "Addness 설정하기"가 들어 있습니다. 그 안의 "1. AI를 Addness에 연결하기" 행에서 "AI에게 묻기" → "Claude Code에서 열기"(또는 "Codex에서 열기")를 누르면, AI가 Addness 연결부터 차례로 진행합니다(→ 목표 페이지). AI 앱 설치부터의 절차는 AI 앱을 설치하고 Addness에 연결하기에 있습니다. 이 글에서는 MCP 연동 부분만 설명합니다.

요청문을 AI에게 보내기

사용하는 AI에게 이 요청문을 보내기만 하면 됩니다.

Addness MCP(https://vt.api.addness.com/mcp)를 설정해 주세요.

설정할 수 있는 부분은 AI가 진행하고, 여러분의 조작이 필요한 부분만 안내해 줍니다. 브라우저에서의 로그인 허가만, AI가 안내한 시점에 직접 진행해 주세요.

AI가 할 수 있게 되는 일

어느 AI에서 연결하더라도 같은 조직의 같은 목표 트리를 읽고 씁니다.

도중에 멈췄다면: 도구별 절차

권한이나 인증에서 설정이 멈춘 경우에는, 아래 절차를 AI에게 보여주거나 직접 이어서 진행해 주세요.

ChatGPT (공식 플러그인)

ChatGPT에서 “@Addness”를 입력하거나 앱 목록에서 Addness를 선택하세요. “연결”을 누르고 Addness에 로그인한 뒤 “허용”을 누르세요. Free 플랜에서도 사용할 수 있습니다. 쓰기 작업에는 확인이 필요합니다. 연결할 수 있는 것은 이미 있는 Addness 계정뿐입니다(ChatGPT 화면에서는 새로 가입할 수 없습니다).

Claude Code(터미널)

1. Addness MCP를 추가한다(--scope user로, 어느 프로젝트에서든 사용할 수 있습니다)

claude mcp add --transport http --scope user addness https://vt.api.addness.com/mcp

1. Addness에 로그인한다(브라우저가 열리면, Addness 계정으로 허가)

claude mcp login addness

1. 연결을 확인한다(목록에 addness가 나오면 완료. Claude Code 내의 /mcp에서도 확인할 수 있습니다)

claude mcp list

Codex(CLI)

브라우저에서 Addness에 로그인하기만 하면 사용할 수 있습니다. API 키 생성은 불필요합니다(오래된 Codex는 OAuth 미지원이므로, 최신 버전으로 업데이트한 후 실행해 주세요).

1. Addness MCP를 추가한다(자동으로 브라우저가 열리므로, Addness 계정으로 허가. 설정은 ~/.codex/config.toml에 저장됩니다)

codex mcp add addness --url https://vt.api.addness.com/mcp

1. 연결을 확인한다(Auth가 OAuth로 되어 있으면 완료. 로그인이 시작되지 않은 경우에는 codex mcp login addness를 실행)

codex mcp list

Cursor

1. ~/.cursor/mcp.json을 열고, 다음 설정을 추가합니다(다른 서버가 있는 경우에는 addness 항목만 추가)

{
  "mcpServers": {
    "addness": {
      "url": "https://vt.api.addness.com/mcp"
    }
  }
}

1. Cursor의 Settings → Tools & MCP에서 addness의 Connect를 누르고, 브라우저에서 Addness 계정으로 허가합니다

Claude Desktop

원격 MCP는 설정 파일이 아니라, 커스텀 커넥터로 추가합니다.

1. Customize → Connectors를 열고, + → Add custom connector를 선택
2. 이름을 Addness, URL을 https://vt.api.addness.com/mcp로 하여 저장(Team / Enterprise에서는 Owner에 의한 조직 설정이 필요합니다)
3. Addness의 Connect를 누르고, 브라우저에서 허가한다(대화별로 Connectors에서 활성화할 수 있습니다)

그 외 MCP 지원 클라이언트

Streamable HTTP와 OAuth를 지원하는 MCP 클라이언트라면 연결할 수 있습니다.

1. 서버 이름을 addness, 트랜스포트를 Streamable HTTP로 설정
2. 연결 대상에 https://vt.api.addness.com/mcp를 지정
3. 클라이언트의 인증 버튼에서 Addness에 로그인하고, 도구 목록을 가져올 수 있으면 완료

연결되었는지 확인하기

AI에게 "Addness의 조직 목록을 보여 줘"라고 부탁하세요. 여러분이 속한 조직의 이름이 돌아오면 연결된 것입니다. "Addness의 지금 할 ToDo를 보여 줘"라고 부탁해서, 여러분의 지금 할 ToDo가 돌아오는지로도 확인할 수 있습니다.

조직이 여러 개인 분은 작업을 시작하기 전에 AI에게 "Addness의 조직을 〈조직 이름〉(으)로 전환해 줘"라고 부탁하세요. AI는 작업할 조직을 전환합니다(switch_organization). 이미 그 조직에 연결되어 있다면 그대로입니다. 전환한 조직은 같은 AI의 다음 대화에도 이어집니다.

"Addness 도구가 없다" "인증이 필요하다"라는 답이 돌아오면 연결되지 않을 때를 보세요.

화면에서 넘기려면 "AI에게 묻기"

말로 부탁하는 대신, 목표 행의 오른쪽에 있는 ✦("AI에게 묻기")에서도 넘길 수 있습니다(스마트폰 폭에서는 행의 "…" → "AI에게 묻기").

• 진행하기: AI가 그 목표의 맥락을 읽고 그대로 진행합니다
• 브레인스토밍하기: AI가 여러분과 대화하면서 정리해 하위 목표 안을 냅니다. OK한 것만 만들어집니다
• 질문하기: 묻고 싶은 것을 적어 넘기면, AI가 목표를 읽고 답합니다. 목표는 바꾸지 않습니다

"Claude Code에서 열기" "Codex에서 열기" "ChatGPT에서 열기"를 누르면, 목표의 URL과 진행 방법이 담긴 지시문으로 AI가 열립니다. "지시문 복사"라면, Cursor 등 다른 AI에 붙여넣어 사용할 수 있습니다. 개인 설정의 "AI"에서 "지시문 전달 대상"을 정해 두면, 매번 고르지 않고 원클릭으로 열 수 있습니다. 무엇이 일어나는지에 대한 자세한 설명은 목표 페이지로.

외부 연동 API와의 차이

MCP 연동은 로그인한 본인의 이름으로 AI가 Addness를 읽고 쓰는 방식입니다. 자사 시스템에서 조직의 멤버와 오늘의 할 일을 읽기만 한다면, 조직에 고정된 키로 호출하는 외부 연동 API(읽기 전용)를 사용하세요. 외부 연동 키는 MCP에서 사용할 수 없습니다. 외부 연동 API는 Addness가 공개하기로 한 조직에서만 사용할 수 있습니다.

연결되지 않을 때

자주 겪는 문제와 해결 방법입니다. AI 앱을 설치하고 연결하는 방법은 AI 앱을 설치하고 Addness에 연결하기에 있습니다.

Addness 도구를 쓸 수 없다

• 연결했는데 AI가 "Addness 도구가 없다"고 한다: 컴퓨터의 Claude Code 또는 Codex에서 연결한 직후에는 AI 앱을 다시 열 때까지 도구가 보이지 않습니다. 앱을 종료한 뒤 다시 열고, 같은 대화를 선택해 "계속"이라고 보내세요. 창을 닫는 것만으로는 종료되지 않습니다. Mac에서는 Command + Q로 종료합니다. Windows에서는 Alt + F4로 닫고, 화면 오른쪽 아래에 아이콘이 남아 있으면 마우스 오른쪽 버튼으로 클릭해 "종료"를 선택합니다. 터미널에서는 Ctrl + C를 두 번 눌러 종료하고, claude --resume(Codex는 codex resume)으로 같은 대화로 돌아갑니다
• 다시 열어도 "없다"고 한다: Claude Code는 Addness 도구를 사용할 때까지 불러오지 않는 경우가 있습니다. AI에게 "Addness 도구를 찾아서 사용해 줘"라고 전하세요
• 도구를 쓸 때마다 허용을 요청하며 멈춘다: AI에게 "Addness 도구를 매번 확인하지 않고 쓸 수 있게 설정해 줘"라고 부탁하세요. Claude Code에서는 설정 파일(~/.claude/settings.json)의 허용 목록에 mcp__addness가 추가됩니다
• 컨텍스트를 비우려고 Addness 도구를 빼 두었다: 빼 둔 동안에는 AI가 Addness의 목표도 ToDo도 읽을 수 없습니다. Addness와 함께 일할 때는 연결해 둔 채로 두세요. 뺐다면 AI에게 "Addness 도구를 다시 활성화해 줘"라고 부탁하고 앱을 다시 여세요
• 브라우저의 Claude 또는 ChatGPT에 Addness가 표시되지 않음: ChatGPT에서는 공식 플러그인으로, 브라우저의 Claude에서는 맞춤 커넥터로 Addness를 연결하세요. 휴대폰만으로 Addness 사용하기를 참고하세요.

로그인이 진행되지 않는다·연결이 끊긴다

• 로그인 화면이 열리지 않는다: AI에게 "Addness 로그인을 시작하고 URL을 보여 줘"라고 부탁하세요. 표시된 URL을 브라우저에 붙여 넣어 열고 "허용"을 누르세요. "허용" 화면이 나오지 않거나 다른 브라우저가 열렸다면 AI 앱을 설치하고 Addness에 연결하기의 "잘 되지 않을 때"를 보세요
• "허용"을 눌렀는데 오류가 난다: 로그인 화면을 연 채로 시간이 지나면 "승인 코드를 생성하지 못했습니다" 같은 오류가 납니다. AI에게 로그인을 다시 시작해 달라고 하고, 열린 화면에서 바로 "허용"을 누르세요
• 전에는 쓸 수 있었는데 로그인이 필요해졌다·여러 번 로그인을 요구받는다: Addness 연결은 90일이 지나면 끊깁니다. 90일보다 빨리 끊기는 것은 다음과 같은 경우입니다. 같은 AI 앱에서 다시 연결하면, 그 앱의 이전 연결은 끊깁니다. 한 사람이 만들 수 있는 연결은 20개까지이며, 넘으면 가장 오래 사용하지 않은 연결부터 끊깁니다(컴퓨터나 AI를 여러 대·여러 개 쓰는 분은 이 때문에 오래된 연결이 끊길 수 있습니다). AI에게 "Addness에 다시 로그인해 줘"라고 부탁하고 브라우저에서 "허용"을 누르세요
• 회사 계정과 개인 계정을 혼동했다: AI가 연결되는 계정은 "Addness MCP에 연결" 화면에 "… 계정으로 로그인 중"이라고 나오는 계정입니다. "허용"을 누르기 전에 메일 주소를 확인하세요. 다른 계정으로 연결했다면 브라우저의 Addness에 올바른 계정으로 다시 로그인한 뒤, AI에게 "Addness에 다시 로그인해 줘"라고 부탁하세요

다른 조직에 연결되어 있다

• AI가 "대상을 찾을 수 없다"고 한다, 다른 조직의 목표를 읽고 있다: AI가 연결되는 조직은 "허용"을 눌렀을 때 브라우저의 Addness에서 선택되어 있던 조직입니다. 조직이 여러 개인 분은 AI에게 "Addness의 조직을 〈조직 이름〉(으)로 전환해 줘"라고 부탁하세요. 목표의 URL을 건넬 때도 그 목표가 있는 조직으로 전환한 뒤에 부탁하세요

Windows에서 멈춘다

• Codex로 연결하는 도중이나 스마트폰에서 보낸 요청이 멈춘다: Codex 앱을 설치한 것만으로는 컴퓨터에서 codex 명령을 쓸 수 없는 경우가 있습니다. Windows에서 이것이 원인이었던 사례가 있습니다. AI에게 "codex 명령을 쓸 수 있는지 확인하고, 쓸 수 없으면 설치해 줘"라고 부탁하세요. "Codex에서 열기"를 눌러도 Codex가 열리지 않으면 "지시문 복사"를 눌러 Codex에 붙여 넣고 보내세요
• Windows용 Codex에서 Addness 로그인이 끝나지 않는다: Codex를 최신 버전으로 업데이트한 뒤 다시 로그인하세요. 그래도 끝나지 않으면 Claude Code로 연결할 수도 있습니다

<a id="mobile-only"></a>

휴대폰만으로 Addness 사용하기

• ChatGPT 앱: ChatGPT에서 “@Addness”를 입력하거나 앱 목록에서 Addness를 선택하세요. “연결”을 누르고 Addness에 로그인한 뒤 “허용”을 누르세요.
• Claude 앱: Safari에서 claude.ai 열기 → 사용자 지정 → 커넥터 → ＋추가 → 맞춤 커넥터 추가 → 이름 Addness, URL https://vt.api.addness.com/mcp → 연결 후 허용. Claude 앱에서 Addness를 켜고 지시문을 붙여넣은 후 보내세요.
• 컴퓨터에서 계속하기: 휴대폰에서 보낸 요청이 전달되지 않음을 참고해 컴퓨터의 AI에게 작업을 보내세요.

<a id="phone-pc-relay"></a>

스마트폰에서 요청할 수 없다

“휴대폰에서 보낸 요청이 전달되지 않음”에서는 컴퓨터의 AI에게 작업을 보내는 방법을 설명합니다. 휴대폰만 사용하는 경우 “휴대폰만으로 Addness 사용하기”를 참고하세요.

스마트폰의 Addness 앱에 있는 "AI에게 묻기"는 컴퓨터의 Claude Code·Codex에 요청을 전달합니다. 컴퓨터에 Addness 데스크톱 앱(→ 웹 버전과 데스크톱 앱)이 설치되어 있고 같은 Addness 계정으로 로그인한 채 열려 있어야 하며, 컴퓨터가 깨어 있어야 합니다. 스마트폰에서 열고 있는 조직과 데스크톱 앱의 조직도 같게 맞추세요. 이 준비는 컴퓨터에서 "휴대폰에서 AI에게 일 맡기기" 목표를 AI에게 맡기면 AI가 진행합니다. 회사의 Windows 컴퓨터에서는 데스크톱 앱을 실행할 수 없는 경우가 있습니다.

• "컴퓨터의 AI와 아직 연결되지 않았어요"라고 나온다: 컴퓨터 준비가 끝나지 않았습니다. 컴퓨터에서 Addness를 열고 "휴대폰에서 AI에게 일 맡기기"의 "AI에게 묻기"(✦)를 눌러 진행하세요
• "PC가 켜지면 시작합니다"라고 나온 채 움직이지 않는다: 컴퓨터가 절전 상태이거나 데스크톱 앱이 닫혀 있습니다. 컴퓨터를 깨우고 앱을 열면 시작됩니다. 24시간이 지나면 요청은 취소됩니다
• "PC에서 Codex를 찾을 수 없습니다"라고 나온다: 컴퓨터에 codex 명령이 설치되어 있지 않습니다. 컴퓨터의 AI에게 "codex 명령을 설치해 줘"라고 부탁하고, 설치한 뒤 데스크톱 앱을 다시 여세요
• Mac의 ChatGPT 앱에 들어 있는 Codex를 사용하고 있다: ChatGPT 앱 안의 Codex는 데스크톱 앱에서 찾을 수 없습니다. 컴퓨터의 AI에게 "codex 명령을 설치해 줘"라고 부탁하고, 설치한 뒤 데스크톱 앱을 다시 여세요(데스크톱 앱이 Codex를 찾는 곳은 홈 폴더의 .local/bin과 터미널이 명령을 찾는 곳뿐입니다)
• "PC의 Addness에서 작업 폴더를 선택해 주세요" 또는 "PC의 Addness에서 작업 폴더가 선택되지 않았습니다"라고 나온다: 컴퓨터에서 데스크톱 앱 설정의 "リモート操作"(원격 조작)를 열고, 맨 위의 "作業フォルダ"(작업 폴더)에서 AI가 작업할 폴더를 선택하세요. 선택하기 전에는 Claude Code에도 Codex에도 요청이 도착하지 않습니다
• "PC의 Addness를 업데이트해 주세요"라고 나온다: 컴퓨터의 데스크톱 앱이 오래된 버전입니다. 최신 버전으로 업데이트한 뒤 다시 보내세요
• "PC의 Addness에서 Codex의 “스마트폰에서 받기”가 꺼져 있습니다"라고 나온다: 컴퓨터에서 데스크톱 앱 설정의 "リモート操作"(원격 조작)를 열고, "Codex" 항목의 "スマホから受け付ける"(스마트폰에서 받기)를 켜세요(먼저 "作業フォルダ"(작업 폴더)를 선택해 둡니다)
• Claude Code에 전달되지 않는다: 스마트폰의 Claude 앱에 컴퓨터와 같은 Claude 계정으로 로그인되어 있는지 확인하세요

그래도 연결되지 않는다

• 어떤 절차로도 연결되지 않는다: 백신 프로그램이나 회사 네트워크가 Addness와의 통신을 막고 있는 경우가 있습니다. 프로그램 설정에서 vt.api.addness.com을 검사 대상에서 제외해 연결된 사례가 있습니다. 회사 컴퓨터라면 정보시스템 담당자에게 문의하세요
• 여기까지 해 봐도 진행되지 않는다: 멈춘 화면의 스크린샷을 첨부해 도움말 홈의 "Addness 관련 문의"로 연락해 주세요