Coding Tools MCP

Coding Tools MCP는 Rust + Tauri 2 데스크톱 애플리케이션입니다. 프로젝트 디렉터리를 선택하고 서비스를 시작하면 AI Agent가 MCP를 통해 파일을 읽고, 코드를 수정하고, 명령과 테스트를 실행하고, Git 상태를 확인하며, 핵심 진행 상황을 프로젝트 내 히스토리 세션으로 저장할 수 있습니다. 이는 "AI가 개발 진행 상황을 기억하는 IDE 작업 공간을 여는 것"에 더 가깝습니다. 일반 개발 도구는 먼저 Task를 생성할 필요가 없으며, 히스토리 세션은 새 대화에서 컨텍스트를 복원하는 역할을 담당합니다.

하나의 데스크톱에서 작업 공간, MCP 서비스, 연결 정보 및 세션 복원 프롬프트를 동시에 관리합니다.

30초 만에 사용법 파악하기

下载安装桌面端
  → 添加项目目录
  → 启动 MCP 和公网隧道
  → 复制“公网 MCP 地址”
  → ChatGPT 开启开发人员模式
  → 新建 MCP 插件并粘贴地址
  → 完成授权，在新对话中开始开发

처음 사용할 때는 두 가지만 기억하면 됩니다: 데스크톱이 프로젝트를 MCP 작업 공간으로 만들고, ChatGPT가 공개 네트워크 /mcp 주소로 연결합니다.

• 전체 설치 및 데스크톱 시작 단계 보기

• ChatGPT 플러그인 구성 바로 보기

5분 만에 시작하기

1. 데스크톱 클라이언트 설치

Releases를 열고 해당 설치 패키지를 다운로드합니다:

macOS 설치 패키지는 현재 서명되지 않았습니다. 시스템이 첫 실행을 차단하는 경우, "시스템 설정 → 개인정보 보호 및 보안"에서 열기를 확인하세요.

2. 프로젝트 작업 공간 추가

1. 왼쪽의 "작업 공간 추가"를 클릭합니다.

2. 프로젝트 루트 디렉터리를 선택합니다.

3. 작업 공간 이름, MCP 포트 및 인증 방식을 설정합니다.

4. 저장하면 작업 공간이 왼쪽 목록에 오래 유지됩니다.

3. 공개 네트워크 터널 구성

AI 클라이언트가 이 로컬에 없는 경우, 로컬 MCP를 HTTPS 주소로 노출해야 합니다:

• "소프트웨어 관리"에서 frpc / cloudflared를 설치하거나 확인합니다.

• "FRP 구성"에서 서버, 포트 및 Token을 저장하거나, 작업 공간에서 Cloudflare를 선택합니다.

• 각 작업 공간에 독립적인 하위 도메인을 입력합니다. 앱이 FRP 프로세스와 여러 프록시 회선을 통합 관리합니다.

FRP 서버 구성은 중앙에 저장되며, 각 작업 공간은 구성을 선택하고 자신의 하위 도메인만 입력하면 됩니다.

사용 가능한 FRPS 서버가 아직 없다면, FRPS 서버 설치 튜토리얼(微信公众号)을 참고할 수 있습니다. 설치가 완료되면 서버 주소, 포트 및 Token을 클라이언트의 "FRP 구성"에 입력하면 됩니다.

4. MCP 시작

작업 공간에 들어가 MCP의 "시작"을 클릭합니다. 클라이언트에 다음이 표시됩니다:

• 로컬 MCP 주소, 예: http://127.0.0.1:28766/mcp;

• 공개 네트워크 HTTPS MCP 주소;

• ChatGPT 연결에 필요한 인증 정보;

• 실시간 로그 및 상태 점검 결과.

시작 후 로컬 및 공개 네트워크 엔드포인트, OAuth 메타데이터 및 MCP 보호 리소스를 직접 확인할 수 있습니다:

상태 점검은 연결 및 인증 메타데이터 사용 가능 여부를 항목별로 표시합니다.

연결 문제가 발생하면 데스크톱을 벗어나지 않고 최근 MCP 요청 로그를 확인할 수 있습니다:

로그를 통해 도구 목록, 히스토리 초기화 및 체크포인트 호출이 실제로 서버에 도달했는지 빠르게 확인할 수 있습니다.

5. AI 클라이언트 연결

MCP를 지원하는 클라이언트는 인터페이스의 공개 네트워크 MCP URL을 사용합니다. OAuth를 사용할 때 클라이언트는 서버 메타데이터를 통해 인증 흐름에 진입합니다. 인증 코드, Client ID 및 Secret은 모두 데스크톱에서 중앙 생성 및 관리할 수 있습니다. 현재 버전은 사전 구성된 OAuth 클라이언트를 사용하므로, ChatGPT 플러그인을 만들 때 정적/수동 OAuth 자격 증명을 선택해야 하며 CIMD를 선택할 필요가 없습니다.

첫 연결 시 히스토리 초기화를 먼저 호출한 뒤 작업 공간을 확인하는 것이 좋습니다:

history_session_bootstrap
server_info
get_default_cwd
git_status
check_exec_environment

이렇게 하면 Agent가 채팅 컨텍스트에 의존하여 현재 프로젝트, 작업 디렉터리 및 실행 기능을 추측할 필요가 없습니다.

ChatGPT의 두 가지 연결 방식

MCP Connector

구성 전에 다음을 확인하세요:

1. 작업 공간의 MCP 서비스와 공개 네트워크 터널이 모두 실행 중인 상태입니다.

2. "상태 점검"의 공개 네트워크 MCP 점검이 통과되었습니다. OAuth를 사용하는 경우 OAuth 보호 리소스 및 인증 메타데이터 점검도 통과했는지 확인하세요.

3. 데스크톱 "GPT 구성" 카드에서 "공개 네트워크 MCP 주소"를 복사합니다. OAuth를 사용하는 경우 OAuth Client ID, OAuth Client Secret 및 인증 코드도 준비합니다.

ChatGPT는 공개 네트워크 HTTPS /mcp 주소를 사용해야 하며, http://127.0.0.1:28766/mcp 같은 로컬 주소는 사용할 수 없습니다. ChatGPT의 메뉴 이름은 버전 및 언어 설정에 따라 약간 다를 수 있습니다.

1. ChatGPT 개발자 모드 켜기

ChatGPT 설정을 열고 "계정 보안 및 로그인"으로 이동하여 "개발자 모드"를 켭니다. 이 스위치를 사용하면 검증되지 않은 MCP 커넥터를 추가할 수 있습니다.

개발자 모드는 높은 권한을 가지므로, 직접 배포했거나 명확히 신뢰할 수 있는 MCP 서비스에만 연결해야 합니다.

2. MCP 플러그인 만들기

ChatGPT 왼쪽에서 "플러그인"으로 이동하고, 오른쪽 상단의 +를 클릭하여 새 플러그인을 만든 다음 MCP(베타)를 선택하고 다음을 입력합니다:

OAuth를 사용할 때 "고급 OAuth 설정"을 확장하고 정적/수동 OAuth 자격 증명을 선택한 다음 데스크톱에서 제공하는 Client ID와 Client Secret을 입력합니다. CIMD를 선택할 필요는 없습니다. 저장하거나 연결하면 ChatGPT가 인증 페이지를 엽니다. 데스크톱 "GPT 구성" 카드의 인증 코드를 입력하여 첫 인증을 완료합니다.

Client Secret, 인증 코드 및 Bearer Token은 모두 민감한 정보이므로 대화, Issue 또는 공개 스크린샷에 붙여넣지 마세요. 데스크톱이 Bearer를 사용하거나 인증을 활성화하지 않는 경우, ChatGPT에서 현재 인터페이스가 제공하는 해당 인증 방식을 선택하세요.

3. 연결 확인

이 플러그인이 활성화된 새 대화를 만들고 다음을 보냅니다:

请使用 Coding Tools MCP 调用 server_info、get_default_cwd 和 git_status，
告诉我当前连接的工作区、默认目录和 Git 状态。

현재 프로젝트 정보가 반환되면 "데스크톱 → 공개 네트워크 터널 → OAuth → ChatGPT → MCP 도구" 체인이 연결된 것입니다. 첫 번째 개발 시 history_session_bootstrap을 호출하여 프로젝트 히스토리를 초기화하거나 복원합니다.

ChatGPT가 여전히 이전 도구 목록을 표시하면 플러그인을 끊고 다시 연결하거나, 새 대화를 만든 후 다시 확인하세요.

자주 묻는 질문

GPT Actions

1. 작업 공간의 Actions 서비스를 시작합니다.

2. Actions 패널의 OpenAPI URL을 복사합니다.

3. GPT 편집기의 Actions 페이지에서 해당 URL을 가져옵니다.

4. 데스크톱 구성에 따라 None, API Key 또는 OAuth를 선택합니다.

MCP와 Actions는 같은 작업 공간에서 동시에 실행할 수 있으며, 각각 다른 포트와 하위 도메인을 사용할 수도 있습니다.

왜 필요한가

• 실제 개발 지향: 파일, 명령, Git, 테스트 및 오래 실행되는 프로세스가 모두 동일한 Workspace에 있습니다.

• 세션 간 지속 개발: 새 대화는 먼저 제한된 현재 상태를 얻고, 정확한 이전 컨텍스트가 필요할 때 키워드로 위치를 찾아 원본 아카이브를 읽으므로, AI에게 프로젝트 배경과 현재 진행 상황을 반복해서 설명할 필요가 없습니다.

• 진행 상황 추적 가능: 각 작업 완료 후 구조화된 체크포인트를 저장할 수 있으며, 결정, 수정, 테스트 결과 및 다음 단계가 모두 프로젝트 디렉터리에 남습니다.

• 다중 작업 공간 관리: 하나의 데스크톱 클라이언트로 여러 프로젝트를 저장하고 각각의 MCP, Actions 및 공개 네트워크 주소를 관리할 수 있습니다.

• ChatGPT 연결이 더 직접적: Streamable HTTP, OAuth, Bearer Token, OpenAPI, FRP 및 Cloudflare 터널이 내장되어 있습니다.

• 기본 도구는 단순 유지: 안정적인 핵심 도구가 기본으로 제공되며, 고급 Harness 기능은 필요에 따라 활성화됩니다.

프로젝트가 각 대화를 기억하게 하기

일반 채팅 기록은 대화 내용을 다시 보기에는 적합하지만, 장기 개발 인계에는 적합하지 않습니다. Coding Tools MCP는 세션 진행 상황을 현재 프로젝트의 docs/history-session/에 기록하여, 컨텍스트가 특정 채팅 창에 갇히지 않고 프로젝트를 따라가도록 합니다.

전체 프롬프트를 새 세션에 복사하면 히스토리를 초기화하거나 복원할 수 있습니다. 각 작업 완료 후 체크포인트를 저장합니다.

서로 협력하는 다섯 가지 히스토리 도구를 제공합니다:

일반적인 효과:

对话 1：分析项目 → 修改代码 → 运行测试 → 保存检查点
                                      ↓
对话 2：读取有界当前状态 → 搜索并精读需要的旧档案 → 从上次进度继续 → 保存新检查点

히스토리 아카이브는 읽기 쉬운 Markdown 형식으로, 프로젝트와 함께 백업하거나 Git에 포함할 수 있으며, 개발자가 직접 검토하고 수정하기도 쉽습니다. memory/state.json은 제한된 현재 상태 프로젝션이고, memory/manifest.json은 위치, 해시 및 키워드만 저장하며 본문을 복사하지 않습니다. Markdown이 장기적이고 무손실인 사실 소스입니다. 첫 입력과 각 입력은 ChatGPT가 initial_user_input, raw_user_input 도구 매개변수로 전달해야 하며, 서버는 전달되지 않은 원격 채팅 텍스트를 읽을 수 없습니다. 체크포인트는 멱등적 추가를 사용하며, 동일한 turn_id의 내용이 변경되면 revision 및 supersedes 증거를 보존하고, ok=true가 반환되고 세션 목표가 일치한 후에만 저장 성공을 확인합니다.

히스토리 영속화는 AI가 MCP 도구를 호출하여 수행되며, 데스크톱이 백그라운드에서 채팅 내용을 녹화하는 것이 아닙니다. 클라이언트가 도구 호출을 트리거하지 않으면 서버는 새 대화나 작업 진행 상황을 알 수 없습니다.

Agent가 할 수 있는 일

기본 core 프로필은 안정적이고 조합 가능한 개발 도구 세트를 제공합니다:

일반적인 개발 과정:

打开 Workspace
  → 理解项目和 Git 状态
  → 搜索并读取代码
  → 事务化应用 Patch
  → 运行命令和测试
  → 检查 diff 并提交

고급 프로파일은 프로젝트 상태, 작업 기록 등 Harness 기능도 유지하지만, 일반 파일 수정과 명령 실행에는 먼저 Task를 만들 필요가 없습니다.

권한 및 복구 모델

프로젝트는 Workspace-first 권한 모델을 사용합니다:

• Workspace 내 일반 파일은 읽기, 생성, 수정, 삭제 및 실행이 가능합니다.

• Workspace 외부는 전체 읽기 전용이 허용됩니다: read_file, list_dir, list_files, search_text, view_image.

• Workspace 외부의 쓰기, 삭제 및 실행은 차단됩니다.

• .git 및 .github는 일반 파일 도구, Patch 또는 인터프리터 명령으로 손상될 수 없습니다.

• Patch는 단일 작업 내에서 사전 검사와 실패 복구를 수행합니다. 장기 복구는 Git을 통일적으로 사용하며 전체 Workspace Snapshot을 만들지 않습니다.

Windows 하위 프로세스는 현재 policy_only 실행 경계이며, 반환의 sandbox_enforced: false는 실제 상태입니다. 정적 명령 정책은 완전한 운영체제 파일 시스템 샌드박스와 동일할 수 없습니다.

로컬 개발

환경 요구 사항: Node.js 20+, Rust stable, 그리고 현재 시스템의 Tauri 2 prerequisites.

npm install
npm run desktop

일반적인 검증 명령:

npm run check
npm run build
cd src-tauri && cargo test
cd src-tauri && cargo clippy --all-targets -- -D warnings

Windows에서는 dev-desktop.cmd를 더블클릭할 수도 있습니다. npm run dev만으로 데스크톱 앱을 검증하지 마세요. Vite만 시작하고 Tauri 셸은 시작하지 않습니다.

프로젝트 구조

감사의 말

Linux.do 커뮤니티의 프로젝트 홍보와 피드백 지원에 감사드립니다.

License

Apache-2.0