개인 API 키로 n8n 연결하기
n8n-nodes-marcomm 커뮤니티 노드는 보도자료, 블로그 글, 프레스 이벤트, RSVP 초대장을 작성하고 승인을 요청하고 공개합니다. 패키지는 아직 공개 전입니다.
- 1Marcomm에서 설정 → 연동 → n8n로 가서 지금 상태와 필요한 값을 확인합니다.

n8n 화면에는 지금 상태, 연결 단계, 복사할 값, 이 워크스페이스의 API 사용 승인 여부가 나옵니다. - 2설정 → API를 엽니다. 워크스페이스에 아직 API 사용 승인이 없으면 소유자나 관리자가 API 사용 신청을 채우고 신청하기를 누릅니다.
- 3승인되면 키 만들기를 열고 개인 키를 고른 뒤 필요한 범위를 체크하고 키 만들기를 누릅니다. 키는 한 번만 보이니 바로 복사합니다.
- 4n8n Cloud에서는 노드 패널에서 Marcomm AI를 검색합니다(보이지 않으면 관리자 패널에서 Verified Community Nodes를 켜고 인스턴스를 다시 시작합니다). 직접 설치한 n8n에서는 Settings(설정), Community Nodes, Install(설치)을 차례로 열고
n8n-nodes-marcomm을 입력합니다. - 5Marcomm AI API 자격 증명을 만들어 API Key(API 키)에 키를 붙여 넣고, 워크플로에 Marcomm AI 노드나 Marcomm AI Trigger 노드를 더합니다.
트리거 노드는 콘텐츠 범위가 필요하며, 첫 확인에서는 아무것도 보내지 않아 지난 항목을 다시 내보내지 않습니다.
노드는 보도자료, 블로그 글, 프레스 이벤트, RSVP 초대장과 승인(승인, 반려, 대기 중인 승인 목록)을 다룹니다. 트리거 노드는 보도자료가 만들어지거나 승인 요청되거나 공개될 때, 블로그 글이 만들어지거나 공개될 때, 프레스 이벤트가 만들어질 때 워크플로를 시작합니다.
범위는 키가 할 수 있는 일을 정합니다. 콘텐츠(content)는 보도자료, 블로그 글, 프레스 이벤트를 읽고, 콘텐츠 작성(content:write)은 초안을 만들고 고치며, 공개와 송출(distribution)은 공개하고 이메일로 보내고, 승인(approvals)은 승인 단계를 다룹니다. 뒤의 세 범위는 개인 키로만 쓸 수 있습니다. 한 일이 키를 만든 사람의 이름으로 기록되기 때문입니다. 워크스페이스 키는 읽기만 할 수 있고, 모든 키는 만든 사람의 역할과 권한으로 동작합니다.
공개와 송출은 되돌릴 수 없습니다. API는 요청에 confirm: true나 Idempotency-Key 헤더가 있을 때만 실행하고, 아직 승인이 필요하거나 예약 공개 또는 엠바고가 걸린 글이면 공개하지 않고 409로 답합니다. 같은 Idempotency-Key로 같은 요청을 다시 보내면 24시간 동안 다시 실행하지 않고 처음 결과를 돌려줍니다. 노드는 쓰기 요청마다 실행, 노드, 항목으로 만든 멱등 키를 보내고, 공개와 송출 작업은 스스로 확인값을 붙입니다.
API는 Team 요금제 이상에서 쓸 수 있습니다. Marcomm AI 팀이 신청을 하나씩 심사하며, 키는 승인된 뒤에만 동작합니다. 키에는 워크스페이스에 승인된 범위만 넣을 수 있고, 한 사람당 키를 10개까지 만들 수 있습니다. 기본 한도는 워크스페이스당 분당 60회, 하루 10,000회이며, 넘으면 API가 Retry-After 헤더와 함께 429로 답합니다. 한도를 올리려면 설정 → API의 한도를 더 올려야 하나요?를 쓰세요. n8n 연결을 끊으려면 키 옆의 끄기를 누릅니다. 그 키를 쓰던 시스템은 바로 접근을 잃습니다.
자주 묻는 질문
Authorization: Bearer뒤에 키를 붙인 헤더로GET https://marcomm.works/api/v1/me를 호출하세요. 범위와 상관없이 승인된 키면 동작하고, 워크스페이스와 키 이름, 키의 범위를 돌려줍니다.키에는 어떤 서비스가 쓰는지 기록되지 않아 Marcomm이 n8n 카드를 연결됨으로 표시하지 않습니다. 각 키를 마지막으로 쓴 시각은 설정 → API에서 확인합니다.
네, 기본 HTTP Request 노드로 쓸 수 있습니다.
Authorization: Bearer뒤에 키를 붙인 헤더로https://marcomm.works/api/v1를 호출하고, 쓰기 요청마다Idempotency-Key헤더를 넣으세요.