# 토닥토닥

> 토닥토닥은 한국 IT 채용·교육·공모전·해커톤·자격증·어학 시험의 공고와 지원서 문항, 사이트별 작성 스킬을 모으는 서비스예요. AI 에이전트는 MCP로 연결해 공고를 찾고, 사용자가 승인한 자료로 지원서를 준비·제출한 뒤 접수 결과를 비공개 지원 기록에 남겨요.

**AI 에이전트라면 MCP로 연결하세요.**

- 연결 주소: `https://todaktodak.app/mcp/auth` (Streamable HTTP · OAuth). 익명 요청에 HTTP 401로 답해서 연결할 때 로그인 창이 열려요.
- 로그인 없는 MCP 서버: `https://todaktodak.app/mcp`. 공개 검색, 연결 키(PAT), 이미 등록한 연결이 써요. 도구와 권한 검사는 같아요.
- 클라이언트 등록: CIMD(공개 클라이언트 메타데이터 문서) 또는 DCR(`POST https://todaktodak.app/oauth/register`). 둘 다 Authorization Code + PKCE S256이에요.

## 시작하기

- [에이전트 이용 가이드](https://todaktodak.app/agent-guide.md): 현재 AI의 MCP 연결부터 자료 승인, 작성·제출·결과 기록까지 이어가는 절차예요.
- [AI 연결 화면](https://todaktodak.app/?tab=agents): 사람이 AI별 연결 순서를 보고 연결 키를 발급하는 화면이에요.
- 실제 회사 없이 지원 흐름 전체를 시험하려면 `create_test_application`으로 소유자 전용 시험 접수처를 만들고 실제 지원과 같은 순서로 진행해요. 실제 지원이 아니에요.

## 인증이 필요한 작업

- MCP 서버: https://todaktodak.app/mcp (Streamable HTTP)
- HTTP 작업 API: https://todaktodak.app/api/v1/operations (Bearer 인증)
- [OAuth 리소스 메타데이터](https://todaktodak.app/.well-known/oauth-protected-resource/mcp)
- [OAuth 서버 메타데이터](https://todaktodak.app/.well-known/oauth-authorization-server)
- [승인한 연결 관리](https://todaktodak.app/oauth/connections)

## 지켜 주세요

- 채팅 AI는 현재 실행 환경의 공식 연결·플러그인 기능으로 MCP 연결을 시작하세요. 원격 MCP 연결에 CLI 설치는 필요하지 않아요.
- 직접 HTTP를 사용하는 에이전트·서버·터미널은 연결 키(PAT)나 OAuth access token으로 공통 v1 API를 호출해요. 토큰의 OAuth resource는 같은 서비스의 /mcp이고 개인 자료·지원 작업의 위임도 그대로 검사해요.
- Python `urllib`의 기본 User-Agent는 Cloudflare가 일부 경로에서 막아요(403, 오류 1010). 프로그램 이름을 담은 User-Agent를 보내세요.
- 공개 웹은 연결 안내를 확인하는 용도로만 써요. 인증 실패·권한 부족·취소·거절 뒤 인터페이스를 바꾸어 재시도하지 않아요. 연결이나 위임의 원인을 먼저 해결하고 같은 지원 목표를 이어가요.

## Optional

- [공개 읽기 API 명세](https://todaktodak.app/openapi.json): 공개 공고·자격증·페이지 스킬을 읽는 HTTP 계약이에요. 개인 자료와 MCP는 들어 있지 않아요.