메시징 플랫폼은 저마다 자기 API를 만듭니다. 자기 키, 자기 웹훅 형식, 자기만의 오류 개념을 갖습니다. 그중 다섯 개를 하나의 제품 뒤에 두면, 팀은 로고만 같은 통합 다섯 개를 유지보수하게 됩니다. 우리는 반대로 갔습니다.
어디서나 같은 것
- 키. X-API-KEY 헤더에 담은 API 키 하나로 LinkedIn API, Inbox API, WhatsApp API, Discord API, X API에 닿습니다. 조직은 키가 정하고, 무엇을 지정할 수 있는지는 조직이 정합니다.
- 경계. 조직의 것이 아닌 것은 모두 404로 응답합니다. 403이 아닙니다. 그래서 짐작한 ID로는 아무것도 알 수 없습니다.
- 오류. JSON 형식은 하나이며 {"type":"errors/<code>","status":<n>,"detail":"..."}입니다. detail은 사람에게 보여 주도록 쓰여 있습니다.
- 웹훅. 엔드포인트 체계가 하나이고 서명 방식도 같으며, LinkedIn API의 이벤트와 모든 채널의 이벤트를 똑같이 전달합니다.
- 요금제. 가장 많은 쪽으로 세는 시트, 그리고 하나의 구독과 30일 체험 하나.
AI 에이전트가 얻는 것
MCP 서버는 도구 목록과, 그 도구들이 어떻게 동작하는지에 대한 약속입니다. 모든 채널이 같은 약속을 지키기 때문에, AI 에이전트 하나가 다섯 가지 방언을 배우지 않고도 전부를 다룰 수 있습니다. /mcp의 올인원 에이전트에는 모든 도구가 있고, 각 채널의 에이전트 — /inbox/mcp, /whatsapp/mcp, /discord/mcp, /x/mcp — 에는 그 채널의 도구만 있습니다. 한 채널만 만지고 다른 것은 건드리지 않아야 하는 어시스턴트를 위한 것입니다.
같은 에이전트가 Claude에서도, ChatGPT에서도, MCP를 쓰는 다른 어떤 것에서도 동작하며, 프로젝트 룸 안에서도 동작합니다. 룸에서는 사람들이 각 호출과 그 답을 일어나는 대로 봅니다.
이 모든 것의 대가는 채널이 조금 덜 자기다워진다는 점입니다. 플랫폼 고유의 별난 점은 여전히 남아 있고 각 레퍼런스가 그것을 알려 주지만, 전부 같은 문 뒤에 있을 뿐입니다.
자주 묻는 질문
어시스턴트에게는 올인원 에이전트를 줘야 하나요, 채널 하나의 에이전트를 줘야 하나요?
그것만 만지면 되는 경우에는 채널 하나의 에이전트를 주세요. WhatsApp에 답하는 어시스턴트가 LinkedIn 도구를 가질 이유가 없습니다. 올인원 에이전트는 내가 직접 함께 일하는 어시스턴트를 위한 것입니다.
웹훅 엔드포인트 하나로 모든 채널의 이벤트를 받을 수 있나요?
네. 받고 싶은 이벤트를 LinkedIn API와 모든 채널에서 함께 골라 한 번만 등록하고, 모두에 같은 서명을 확인하세요.