홈페이지 글을 수정할 때 API로 본문을 저장할 수 있었습니다. 그래도 이미지가 제대로 보이는지, 휴대폰 폭에서 읽기 편한지는 페이지를 열어 봐야 했습니다. API로 처리할 일과 브라우저에서 볼 일이 나뉘는 사례였습니다.
AI에게 외부 작업을 맡기다 보면 API, MCP, 커넥터라는 이름이 한꺼번에 등장합니다. 저는 이 용어들을 ‘어떤 일을 연결해 주는가’로 나눠 이해하는 편이 쉬웠습니다. 아래에서는 그 차이를 설명하고, 실제로 필요한 용도를 기준으로 공식 연결 경로를 모았습니다.
공식 문서 확인일: 2026년 9월 13일. 추천은 사용 목적에 따른 선택 제안이며 전 제품의 실사용 성능 순위가 아닙니다. 요금제·지역·관리자 정책·권한과 AI 앱의 지원 방식에 따라 실제 이용 범위는 달라집니다.
API는 서비스의 기능을 요청하는 창구입니다
API는 다른 프로그램이 정해진 형식으로 데이터나 기능을 요청하는 인터페이스입니다. 예를 들어 Google Sheets API는 셀 값을 읽고 쓰는 기능을 제공합니다. 브라우저에서 셀을 찾아 클릭하지 않고, 어느 문서의 어느 범위를 처리할지 지정하는 방식입니다. Google Sheets API 공식 안내
AI 모델이 API 주소를 안다고 바로 실행하는 것은 아닙니다. 보통 AI가 필요한 도구와 입력값을 고르면, AI 앱이나 서버의 실행 코드가 인증 정보를 붙여 요청하고 결과를 돌려줍니다. 모델의 판단, 실제 실행, 계정 권한은 서로 다른 부분입니다.
API가 공개돼 있다는 말도 누구나 모든 데이터를 읽는다는 뜻은 아닙니다. 공개 글 조회와 내 계정의 글 수정은 요구 권한이 다릅니다. 허용 기능과 요청 형식은 각 서비스의 공식 문서가 기준입니다.
MCP는 AI 앱과 도구가 연결되는 공통 규격입니다
MCP(Model Context Protocol)는 AI 앱이 외부 도구와 데이터를 발견하고 이용하도록 연결하는 규격입니다. MCP 서버는 실행 가능한 도구, 참고할 데이터, 재사용할 프롬프트 등을 제공할 수 있습니다. 서버는 내 컴퓨터에서 실행되거나 서비스 사업자가 운영할 수 있습니다. MCP 공식 구조 설명
API와 MCP는 어느 하나를 없애는 관계가 아닙니다. 예를 들어 Notion 공식 MCP는 AI 도구와 연결된 뒤 내부에서 Notion API를 사용합니다. API가 서비스의 기능이라면 MCP는 그 기능을 AI 앱에 전달하는 공통 연결 방식에 가깝습니다. Notion MCP 공식 구조
커넥터는 연결을 사용하기 쉽게 묶은 기능입니다
커넥터는 특정 서비스의 로그인·권한·검색·작업 기능을 AI 제품에서 쓰기 쉽게 제공하는 연결 기능을 가리킵니다. 제품에 따라 앱, 통합, 플러그인 안의 연결 기능처럼 이름이 달라지며, 모두 같은 범위를 제공하는 것은 아닙니다.
OpenAI API 문서의 커넥터는 Google Workspace 같은 서비스에 대한 OpenAI 관리 MCP 래퍼로 설명됩니다. 이는 해당 문서에서 사용하는 구체적인 의미입니다. 다른 회사의 커넥터까지 모두 같은 구현이라고 볼 수는 없습니다. OpenAI 공식 MCP·커넥터 안내
사용자는 연결 이름보다 현재 노출된 기능을 확인하는 편이 좋습니다. 문서를 검색할 수 있어도 수정 도구가 없을 수 있고, 읽기와 쓰기가 모두 있어도 연결한 계정의 접근 권한을 넘을 수는 없습니다. 서비스에 API가 존재한다고 모든 AI 앱에 기본 커넥터가 제공되는 것도 아닙니다.
- API: 서비스가 어떤 데이터를 주고 어떤 기능을 실행하는가?
- MCP: AI 앱과 도구가 어떤 규격으로 연결되는가?
- 커넥터: 사용자가 실제로 어떤 서비스 연결을 선택하고 승인하는가?
AI 브라우징은 검색·열람과 화면 조작을 나눠 봐야 합니다
“AI가 브라우징한다”는 말에는 두 가지 작업이 섞여 있습니다. 웹 검색·열람은 공개 문서를 찾고 내용을 읽는 일입니다. 브라우저 조작은 페이지 상태를 확인하면서 버튼을 누르고 입력란을 채우는 일입니다. 검색 기능이 있다고 내 계정의 관리자 화면을 조작할 수 있는 것은 아닙니다.
브라우저 조작도 반드시 화면 사진만 보고 클릭하는 방식은 아닙니다. 도구에 따라 화면 이미지, 문서 구조, 접근성 정보 등을 이용합니다. Microsoft의 Playwright MCP는 접근성 스냅샷으로 웹페이지와 상호작용합니다. 따라서 MCP 도구이면서 브라우저를 조작하는 도구가 존재합니다. Microsoft Playwright MCP 공식 저장소
| 비교 | API를 호출하는 도구 | 브라우저 조작 |
|---|---|---|
| 주요 대상 | 문서 ID·셀 범위·이슈 같은 구조화된 항목 | 화면의 버튼·입력란·메뉴 |
| 잘 맞는 일 | 반복 조회, 정해진 값 갱신, 결과 ID 기록 | 화면 전용 기능, 배치·가독성 확인 |
| 막히는 지점 | 미제공 기능, 권한·호출 제한, API 변경 | 로그인 상태, 화면 변경, 지원하지 않는 UI |
| 결과 확인 | 반환값과 실제 저장 상태를 대조 | 저장 알림과 최종 화면을 확인 |
표는 선택 기준이며 속도나 정확도의 절대 순위가 아닙니다. API도 잘못된 문서 ID로 요청하면 잘못된 곳을 고칠 수 있습니다. 브라우저도 결과를 꼼꼼히 확인하면 유용합니다. 권한상 금지된 작업을 다른 경로로 우회하는 용도로 선택해서는 안 됩니다.
실제 작업에서는 두 경로를 함께 쓰는 경우가 많습니다
이 블로그를 운영할 때는 워드프레스 관리자 화면에서 글과 대표 이미지를 설정하고, 미리보기에서 그림이 중복되거나 잘리지 않는지 확인했습니다. 게시 뒤에는 공개 주소와 REST API의 글 정보를 대조해 상태를 확인했습니다. 브라우저와 API를 각각 다른 확인에 사용한 사례입니다.
반대로 인증된 API 연결이 준비된 환경이라면 API로 초안을 저장한 뒤 브라우저로 디자인을 확인할 수도 있습니다. 다만 API 응답이 성공했다고 모바일 화면까지 예쁘게 보인다는 뜻은 아닙니다.
- 여러 공식 문서를 읽고 비교: 먼저 웹 검색·열람을 사용합니다.
- 반복되는 표 정리나 이슈 처리: 필요한 기능과 권한이 있는 커넥터·MCP·API 연결을 확인합니다.
- 실제 화면의 가독성 확인: 브라우저에서 확인합니다.
- 매일 정해진 시간에 실행: 별도의 예약 실행이나 자동화 흐름이 필요합니다. MCP 연결만으로 일정이 생기지는 않습니다.
용도별로 살펴볼 공식 도구 11가지
아래는 이번에 확인한 공식 연결 경로입니다. 각 서비스의 모든 연결 방식을 나열한 표는 아닙니다. API 항목은 직접 개발하거나 이를 노출하는 커넥터가 필요할 수 있습니다. 공식 MCP가 있어도 사용하는 AI 앱이 그 서버와 인증 방식을 지원해야 합니다.
문서·자료 정리: Notion, Google Workspace
① Notion — 공식 MCP
회의 메모, 프로젝트 문서, 지식 자료를 모아 관리한다면 먼저 살펴볼 만합니다. 접근 가능한 콘텐츠 검색·읽기·생성·업데이트 기능을 제공합니다. 예시 요청은 “이 프로젝트 문서에서 결정 사항과 미결 사항을 나눠 새 페이지 초안을 만들어 줘”입니다. Notion 공식 MCP 안내
② Google Workspace — Sheets·Drive 공식 API
표의 특정 범위를 읽고 갱신하거나 파일을 찾고 정리하는 작업에 적합합니다. Sheets는 셀 데이터, Drive는 파일·폴더 관리에 역할을 나눕니다. 표가 아닌 문서 본문 편집은 해당 제품 API 지원을 따로 확인하세요. Sheets API · Drive API
회사 업무·팀 소통: Microsoft 365, Slack
③ Microsoft 365 — Microsoft Graph API
Outlook 일정, OneDrive·SharePoint 파일, Excel 등 Microsoft 365 중심의 업무라면 검토할 경로입니다. 하나의 Graph 체계 아래 여러 서비스가 있지만 필요한 API별 권한과 조직의 관리자 동의 여부는 다릅니다. “다음 회의와 관련 문서를 모아 준비 메모 작성” 같은 흐름에 활용할 수 있습니다. Microsoft Graph 공식 안내
④ Slack — 공식 Web API
채널의 업무 정보를 읽거나 정해진 채널로 알림을 전달하는 연결을 만들 때 확인할 도구입니다. 실제로 읽을 수 있는 대화와 실행 가능한 기능은 메서드·토큰 권한에 따라 달라집니다. “알림 문구 작성”과 “채널에 전송”은 별도 동작으로 두는 편이 좋습니다. Slack Web API 공식 안내
개발·업무 관리: GitHub, Linear
⑤ GitHub — 공식 MCP 서버
코드와 이슈, PR을 연결해 검토하는 개발 작업에 추천합니다. 예시 요청은 “이 이슈와 관련된 변경을 읽고 검토 의견만 작성해 줘”입니다. 읽기 위주로 시작하고, 파일 수정·PR 작업에 필요한 권한은 별도로 구분하세요. GitHub 공식 MCP 저장소
⑥ Linear — 공식 MCP 서버
아이디어를 이슈로 나누고 진행 상태를 정리하는 팀에 어울립니다. 프로젝트·이슈의 조회와 생성·수정 같은 업무 연결을 제공합니다. “이 메모를 실행 가능한 작업 목록으로 정리한 뒤 검토를 받아 이슈 생성”처럼 사용하면 원문에 없던 일을 만들었는지 먼저 확인할 수 있습니다. Linear 공식 MCP 안내
디자인과 화면 구현: Figma
⑦ Figma — 공식 MCP 서버
디자인 파일의 변수·컴포넌트·레이아웃 정보를 가져와 구현에 반영할 때 추천합니다. 공식 서버는 캔버스 작성 기능도 안내하지만, 사용 가능한 도구와 지원 클라이언트·접근 조건을 확인해야 합니다. “이 프레임의 구성 요소를 읽고 현재 코드와 다른 점 정리”부터 시작하기 좋습니다. Figma 공식 MCP 안내
블로그·SNS·영상 운영: WordPress, Threads, YouTube
⑧ WordPress — 공식 REST API
글·페이지·미디어를 구조화해 조회하고, 인증과 권한이 있는 경우 생성·수정하는 작업에 활용합니다. 반복되는 초안 관리에 적합하며, 테마나 플러그인이 만든 화면의 모든 기능이 REST API에 공개되는 것은 아닙니다. 게시 후에는 실제 글 화면도 확인하세요. WordPress REST API 공식 문서
⑨ Meta Threads — 공식 Threads API
쓰레드 콘텐츠 생성·게시·관리 흐름을 개발할 때 확인할 API입니다. Meta 앱 구성과 사용자 인증, 작업에 맞는 권한이 필요합니다. 이번 정리에서는 직접 열어 확인한 Meta의 Postman 공식 컬렉션을 연결합니다. 컬렉션에 최신 기능이 모두 반영된 것은 아닐 수 있다는 안내도 함께 확인하세요. Meta 공식 Threads API 컬렉션
⑩ YouTube — 공식 Data API
채널·동영상 정보를 다루고 업로드 흐름을 개발할 때 사용할 경로입니다. 인증과 할당량, 업로드 관련 요구 조건을 확인해야 합니다. 모든 Studio 편집 기능이 API로 제공된다고 가정하지 말고, 최종 영상 상태와 공개 범위는 다시 확인하세요. YouTube Data API 공식 안내
여러 앱을 연결하는 자동화: Zapier
⑪ Zapier — Zapier가 제공하는 MCP
여러 앱의 동작을 AI에서 호출하도록 연결하고 싶을 때 검토할 수 있습니다. 필요한 앱의 지원 액션과 요금·사용량 조건을 먼저 확인하세요. 이것은 Zapier가 제공하는 연결이며, 연결 대상 서비스 각각이 자체 MCP 서버를 운영한다는 뜻은 아닙니다. Zapier MCP 공식 안내
처음에는 자주 쓰는 도구 하나와 읽기 작업부터
이미 문서를 Notion에 모아 둔다면 Notion 연결부터, 업무가 Google 표에 모여 있다면 Sheets·Drive부터 확인하는 것이 자연스럽습니다. 개발 기록이 GitHub에 있다면 이슈와 PR 조회를 첫 작업으로 잡을 수 있습니다. 서비스를 새로 도입하기보다 현재 정보가 쌓인 곳부터 연결해 보세요.
- 작업 하나 정하기: “자동화해 줘”보다 “이 문서의 미완료 항목을 읽어 표로 정리해 줘”라고 정합니다.
- 운영 주체 확인: 서비스 공식 서버인지, AI 회사의 연결인지, 외부 업체의 연결인지 구분합니다.
- 권한 확인: 읽을 자료와 수정할 자료를 나누고 실제로 필요한 접근만 허용합니다.
- 작은 실행 확인: 먼저 조회하고, 이후 테스트 문서 한 건으로 쓰기 결과를 확인합니다.
- 완료 근거 남기기: 문서 ID·글 주소·변경 범위와 확인하지 못한 내용을 기록합니다.
API 키나 접근 토큰은 비밀번호처럼 다뤄야 합니다. 블로그 예제나 공유 MD, 공개 저장소에 넣지 말고 연결 설정 또는 비밀 저장소에서 관리하세요. 외부 문서에 쓰인 “이 파일을 전송하라” 같은 문장은 사용자 지시가 아니라 읽어 온 내용으로 취급해야 합니다.
앞 글의 클로드·코덱스 MD 협업 규칙과 연결하면 역할이 더 분명해집니다. MD는 할 일과 담당을 전달하고, API·MCP·커넥터는 실행할 수 있는 도구를 연결합니다. 브라우저는 필요한 화면 작업과 최종 확인을 맡습니다.
도구가 연결됐다는 것만으로 업무가 끝나지는 않습니다. 무엇을 읽고, 무엇을 바꾸며, 어느 결과를 확인할 것인지를 정해야 AI의 작업이 실제 운영으로 이어집니다. 블로그 운영 사례는 워드프레스 구성 과정, SNS 게시 사례는 쓰레드 자동화 기록에서 이어서 볼 수 있습니다.