에이전트 연결하기

짧은 버전

쓰는 AI에 맞는 플러그인을 설치하고, 브라우저에서 Allow를 한 번 누르면 끝입니다. 일반적인 경로에서는 복사할 토큰도 없고 설정할 것도 없습니다. 이 페이지 아래쪽에 나오는 말들(OAuth, 토큰, streamable HTTP)은 직접 손으로 연결하는 사람을 위한 것이고, 전부 건너뛰셔도 됩니다.

tuckit은 보드를 MCP라는 규격으로 열어둡니다. 코딩 AI들이 바깥 도구를 쓸 때 쓰는 공용 규격입니다. 이 규격을 따르는 AI라면 뭐든 붙일 수 있고, 플러그인은 그 연결 작업을 건너뛰게 해주고 보드를 어떻게 쓰는 건지까지 AI에게 알려줍니다.

뭘 설치하시든 AI는 같은 세 가지를 받습니다.

• 창을 열 때의 안내: 코드가 아니라 보드에서 지금 상태를 읽고, 일을 시작하기 전에 보드를 확인하라는 것.
• 창을 닫을 때의 알림: 결정한 걸 보드에 적어서, “다음엔 X 하자”가 채팅 한 줄이 아니라 카드가 되게 하는 것.
• tuckit-domain 지식: 화면에 보이는 것들의 내용을 AI가 필요할 때 불러 읽는 형태로 넣어둔 것.

쓰는 AI 고르기

Claude Code

붙여넣을 것도 설정할 것도 없습니다.

1. Claude Code 창에서:

   /plugin marketplace add tuck-it/tuckit-plugins
   /plugin install tuckit@tuckit-plugins

2. 연결 설정이 플러그인에 같이 들어 있어서 claude mcp add를 따로 할 필요가 없습니다. 주소는 https://app.tuckit.dev/mcp로 미리 채워져 있으니 Enter를 누르시거나, 직접 설치해서 쓰신다면 본인 주소를 입력하시면 됩니다.

3. AI가 tuckit을 처음 쓰는 순간 브라우저가 열립니다. 한 번 허용하면 끝이고, 자격 증명은 운영체제 키체인에 들어가서 알아서 갱신됩니다.

에이전트가 실제로 일할 때 따라가는 작업 방식들도 같이 들어옵니다. 하나씩은 플러그인이 해주는 일에 적어뒀습니다.

팀과 같이 쓰려면. 설치할 때 --scope project를 붙이면 그 폴더의 .claude/settings.json에 들어가서, 그 폴더를 여는 사람 모두가 쓰게 됩니다. --scope local은 본인만 쓰는 설정입니다. 한 컴퓨터에서 보드를 여러 개 쓰는 건 프로젝트가 여러 개라면에, 직접 설치한 서버에 붙이는 건 직접 호스팅하기에 있습니다.

안 나타나면. /reload-plugins를 실행하고 /plugin list로 확인해보세요. 예전에 claude mcp add tuckit을 직접 하신 적이 있다면 그쪽이 우선합니다. 둘이 충돌하지는 않습니다.

GitHub에서 안 받고 싶다면. /plugin marketplace add는 git 주소나 로컬 경로도 받습니다. 예를 들어 /plugin marketplace add ./tuckit-plugins처럼요.

Codex CLI

1. 마켓플레이스를 추가합니다.

   codex plugin marketplace add tuck-it/tuckit-plugins

2. 창 안의 목록에서 설치하고 켭니다.

   /plugins   →   "tuckit" 선택   →   install   →   enable

3. Codex는 설치 중에 아무것도 물어보지 않습니다. 그래서 토큰을 환경 변수로 직접 넣어줘야 합니다.

   export TUCKIT_MCP_TOKEN="<발급받은_토큰>"

   토큰은 tuckit의 Settings → Agent에서 발급합니다. 매번 다시 입력하지 않으려면 쉘 설정 파일에 넣어두세요.

이걸로 안내, 알림, 지식, 연결이 전부 설정됩니다. ~/.codex/config.toml을 직접 고칠 필요는 없습니다. 직접 설치해서 쓰신다면 서버 주소를 바꿀 수 있습니다. 직접 호스팅하기를 보세요.

실제 설치 환경에서 아직 확인 못 했습니다

Codex 플러그인은 Codex가 문서로 밝힌 훅 형식과 .mcp.json 형식을 따르고 있습니다. 다만 실제로 돌아가는 Codex에 붙여서 확인해보지는 못했습니다. 안내나 알림, 연결이 안 올라오면 쓰시는 Codex 버전의 문서를 확인하고 plugins/codex/hooks/hooks.json이나 plugins/codex/.mcp.json을 고쳐야 할 수 있습니다.

Antigravity

아무 터미널에서 한 줄이면 됩니다.

agy plugin install https://github.com/tuck-it/tuckit-plugins/tree/main/plugins/antigravity

지식과 훅과 연결까지 같이 들어옵니다. AI가 tuckit을 처음 쓸 때 브라우저가 열려서 한 번 허용하면 끝이고, 붙여넣을 토큰은 없습니다.

저장소 주소가 아니라 플러그인 폴더 주소를 넣으세요

저장소 최상위 주소를 주면 agy plugin install이 plugins/ 폴더를 통째로 보고 Claude Code용 플러그인까지 같이 설치합니다. 둘 다 이름이 tuckit이라 같은 폴더에 들어가고, 두 hooks.json이 합쳐집니다. 그리고 합쳐진 파일은 통째로 거부돼서 훅이 하나도 안 걸린 상태가 됩니다. 위 주소 끝의 /tree/main/plugins/antigravity가 그걸 피하는 부분입니다.

Antigravity에는 창을 열 때 실행되는 이벤트가 없습니다. 그래서 안내를 PreInvocation에 태우고 첫 턴에만 들어가게 막아뒀습니다. 매 턴 들어가지 않도록요. 닫을 때의 알림은 Stop에 걸려 있고, 그래서 AI가 처음 끝내려 할 때 한 턴을 더 씁니다.

agy plugin list로 뭐가 깔렸는지 보고, agy plugin disable tuckit으로 끕니다.

아무 일도 안 일어나는 것 같으면

설치할 때 나오는 메시지는 근거가 안 됩니다. 아직 읽지도 않은 파일에 대해 hooks : 2 processed라고 찍습니다. Antigravity는 다음 창이 열릴 때 훅을 읽고, 거부한 파일은 ~/.gemini/antigravity-cli/log/cli-*.log에 한 줄로 남깁니다. 뭘 고치기 전에 그 로그부터 보세요.

agy plugin uninstall tuckit을 해도 ~/.gemini/config/plugins/tuckit/ 폴더는 남습니다. 깨끗하게 다시 깔려면 그 폴더도 지우세요.

직접 손으로 연결하기

플러그인이 없는 AI를 쓰시거나 직접 설치해서 쓰시는 게 아니라면 건너뛰세요. 주소는 쓰시는 tuckit 서버의 /mcp입니다.

https://app.tuckit.dev/mcp

Claude Code는 알아서 인증 방식을 찾아내므로 토큰이 필요 없습니다.

claude mcp add --transport http tuckit https://app.tuckit.dev/mcp

Codex는 환경 변수에서 토큰을 읽습니다. ~/.codex/config.toml에 이걸 넣으세요.

[mcp_servers.tuckit]
url = "https://app.tuckit.dev/mcp"
bearer_token_env_var = "TUCKIT_MCP_TOKEN"

Antigravity도 알아서 찾아내므로 토큰이 없습니다. 모든 창에 적용하려면 ~/.gemini/config/mcp_config.json에 넣으세요.

{
  "mcpServers": {
    "tuckit": { "serverUrl": "https://app.tuckit.dev/mcp" }
  }
}

토큰 발급과, 연결을 허용한 AI를 끊는 것 모두 Settings → Agent에서 합니다.

허용은 어떻게 이뤄지나

방식이 두 개고, 쓰시는 AI가 어느 쪽인지 정합니다. 어느 쪽이든 AI는 결국 조직 하나에 대한 자격 증명만 갖게 됩니다. 한 보드에 연결된 AI는 다른 보드를 읽지도 쓰지도 못합니다.

브라우저에서 허용하는 방식이 좋은 쪽이고, Claude Code와 Antigravity가 이걸 씁니다. 쉽게 말하면 이렇습니다. AI가 브라우저로 tuckit 페이지를 띄우고, 사람이 어느 조직에서 일하게 할지 고른 다음 Allow를 누르면, AI가 짧은 기간짜리 자격 증명을 받아서 알아서 갱신하며 씁니다. 오래 가는 비밀번호 같은 걸 설정 파일에 적어둘 일이 없고, 그 자격 증명이 사람을 가리키기 때문에 AI가 만든 카드에도 사람 이름이 남습니다. 복사할 것도, 주기적으로 갈아줄 것도, 스크린샷에 실수로 찍힐 것도 없습니다.

허용한 AI 목록은 언제든 Settings → Agent에서 보고 끊을 수 있습니다.

고정 토큰은 그게 안 되는 AI를 위한 대안이고, 지금은 Codex가 해당합니다. 직접 만들어서 쉘 설정 파일에 붙여넣는 긴 문자열입니다. 고르시기 전에 두 가지 차이를 알아두세요. 사람이 아니라 조직에 속하기 때문에 쓴 사람 이름이 아니라 조직 이름으로 기록됩니다. 그리고 저절로 만료되지 않기 때문에, 이제부터 그걸 비밀로 지키고 직접 갈아주셔야 합니다.

쓰시는 AI가 둘 다 되면 브라우저 방식을 쓰세요.

됐는지 확인하기

보드에만 있는 걸 물어보면 됩니다.

이 프로젝트 지금 상태 알려줘.

연결된 AI는 조직 이름, 영역 목록, 끝난 것, Inbox에 몇 개 쌓여 있는지를 답합니다. 파일을 읽거나 코드 변경 기록을 뒤져서 답한다면 연결이 안 된 겁니다. 이게 구분법입니다.

다음: 매일의 흐름.