Sendcove 사용하기
Sendcove는 소셜 미디어 스케줄러입니다. Sendcove의 MCP 서버는 사용자의 게시물, 미디어, 분석, 인박스를 관리하는 도구를 제공합니다. Sendcove 도구를 사용할 수 없는 경우, 사용자에게 Sendcove를 연결하도록 안내하세요(설정 가이드: https://www.sendcove.app/features/mcp).
계정부터 시작하기
- 게시물을 만들거나 변경하기 전에
list_accounts를 호출하세요. 반환된id를accountIds로 전달하면 Sendcove가 해당 계정에서 플랫폼을 자동으로 파악합니다. - 사용자가 여러 계정을 가지고 있고 어떤 계정을 사용할지 명시하지 않은 경우, 물어보세요. 기본적으로 모든 계정에 게시하지 마세요.
needsReconnect: true인 계정은 게시에 실패합니다. 사용자에게 Sendcove에서 계정을 다시 연결하도록 안내하세요.
게시물 생성하기
create_post는status를 설정하지 않으면 초안을 만듭니다. 초안은 안전한 기본값입니다. 초안을 생성하고 사용자에게 보여준 후, 예약 또는 게시하도록 하세요.content는 모든 플랫폼의 기본 텍스트입니다.platformContent를 사용하여 플랫폼별로 다른 텍스트를 지정할 수 있습니다. 예를 들어twitter용 280자 버전과instagram용 긴 캡션을 만들 수 있습니다. 키:twitter,instagram,tiktok,threads,bluesky,facebook,linkedin(문자열) 및youtube({ title, description }).- 플랫폼별 옵션(Instagram 게시물 유형, YouTube 동영상 유형 및 공개 설정, TikTok 개인정보 보호, Bluesky 답글 설정, X 커뮤니티 등)은
platformSettings에 설정합니다. 허용되는 필드와 값은 추측하지 말고 도구의 입력 스키마와 설명에서 가져오세요.platformSettings.tiktok을 설정하기 전에get_tiktok_creator_info를 호출하여 해당 계정이 허용하는 개인정보 수준과 상호작용을 확인하세요. - 문자 제한은 게시물이 게시될 때 확인됩니다: X 280자, Bluesky 300자, Threads 500자, Instagram 및 TikTok 2200자, LinkedIn 3000자, YouTube 제목 100자, 설명 5000자. 각 플랫폼의 텍스트가 제한을 초과하지 않도록
platformContent를 사용하세요. 그래야 나중에 게시가 실패하지 않습니다. - Instagram 및 TikTok 게시물에는 미디어가 필요합니다. YouTube에는 동영상 하나가 필요합니다.
- Threads: 후속 게시물은
threadItems로 전달합니다(각{ content, mediaUrls? }). X, Bluesky 및 Threads(Pro 및 Max)에서는 스레드로 게시되고, 다른 플랫폼에서는content만 게시됩니다.update_post에threadItems: []를 전달하면 스레딩이 중단됩니다. - 해시태그:
list_hashtag_sets는 사용자의 저장된 해시태그 세트를 반환합니다(#없이 저장됨). create_post,duplicate_post및reply_to_inbox_item에idempotencyKey(8~200자의 고유한 문자열)를 전달하세요. 호출이 시간 초과되거나 확실하지 않은 경우 동일한 키로 다시 시도하면 중복 게시물이나 답글 대신 첫 번째 결과를 얻을 수 있습니다.update_post는 전달한 필드만 변경하지만,platformContent,platformSettings및threadItems는 각각 저장된 전체 값을 대체합니다. 먼저get_post를 호출하고 전체 객체를 전송하세요.
미디어
- 미디어는
mediaUrls에 사용되기 전에 사용자의 Sendcove 미디어 라이브러리에 있어야 합니다.list_media는 이미 라이브러리에 있는 미디어를 보여줍니다. - 공개 https URL인 경우:
upload_media_from_url을 호출한 후 반환된url을 사용하세요. - 로컬 파일인 경우:
create_media_upload_url을 호출하고 반환된 curl 명령을 실제 파일 경로로 실행하세요(예:curl -s -X POST '<uploadUrl>' -F 'file=@/path/to/photo.jpg'). JSON 응답에 사용할url이 포함되어 있습니다. 업로드 URL은 10분 동안 유효하며 API 키가 필요하지 않습니다. 4MB가 넘는 파일의 경우contentType을 전달하고 두 개의 반환된 명령(스토리지에 PUT, 그다음 finalize POST)을 순서대로 실행하세요. 이미지를 Instagram용 JPEG로 변환하려면-F convertForInstagram=true를 추가하세요. - 허용되는 유형: JPEG, PNG, GIF, WebP, MP4, MOV, AVI.
예약 및 게시
이 대화에서 사용자가 요청한 경우에만 예약, 게시 또는 답변하세요. 게시물을 작성하는 것이 게시 허가는 아닙니다.
- 예약:
status: "scheduled"와 함께scheduledFor를 오프셋이 있는 ISO 8601 형식(2026-11-20T15:00:00Z)으로 설정하세요. 사용자의 현지 시간을 변환하고 시간대가 명확하지 않은 경우 확인하세요. 또는nextOpenSlot: true를 전달하여 해당 계정에 대해 사용자가 설정한 다음 사용 가능한 게시 시간을 사용할 수 있습니다. - 지금 게시:
create_post에status: "pending"을 설정하거나 기존 게시물에publish_post를 호출하세요. - 게시 후
get_post를 호출하세요. 각 계정에는 자체status(published,failed,pending) 및error가 있습니다. 실패한 게시물은 일반적으로 하나의 계정이 실패했음을 의미합니다. 해당 게시물에publish_post를 호출하면 실패한 계정에 대해서만 다시 시도합니다. 이미 게시된 계정에는 다시 게시하지 않습니다. delete_post는 취소할 수 없습니다. 삭제하기 전에 확인하세요.
초안 전용 연결 (403 오류)
예약, 게시 및 답변을 하려면 Pro 또는 Max 요금제 그리고 게시를 허용하는 연결이 필요합니다. Basic 요금제이거나, API 키 또는 연결된 앱이 초안 전용으로 설정된 경우 해당 호출은 403 "이 API 키 또는 연결된 앱은 초안만 만들 수 있습니다" 오류를 반환합니다.
이러한 경우 다시 시도하지 말고 해결 방법을 찾지 마세요. 게시물을 초안으로 저장하고 사용자에게 다음과 같이 알리세요:
Sendcove에 초안으로 저장했습니다. 이 연결은 초안 전용이므로 예약하거나 게시할 수 없습니다. 게시를 허용하려면 Pro 또는 Max 요금제가 필요하며, 여기서 Sendcove를 다시 연결하고 "게시 허용"을 선택하거나(Sendcove의 계정 > API 키에서 "게시 허용"이 활성화된 API 키 사용) Sendcove에서 직접 초안을 예약할 수 있습니다.
분석 및 인박스
get_engagement: 총계, 플랫폼별 분석, 상위 게시물, 각 계정의 최근 베스트 게시물을 자체 중앙값과 비교하여 보여줍니다(timesMedian은 게시물이 얼마나 더 좋은 성과를 냈는지 보여주지만, 그 이유는 알려주지 않습니다).get_post_analytics: 게시된 하나의 게시물에 대한 계정별 지표입니다. 최신 숫자를 얻으려면refresh: true를 전달하세요(1시간 동안 캐시됨). 모든 플랫폼이 모든 지표를 보고하는 것은 아닙니다.get_best_times: 사용자의 자체 참여도를 기반으로 게시하기 가장 좋은 요일과 시간을 알려줍니다.list_inbox/get_inbox_item: 답글, 멘션 및 댓글입니다.reply_to_inbox_item은 공개 답글을 게시하므로, 먼저 사용자에게 텍스트를 보여주고 확인을 받으세요.update_inbox_item은 항목을 읽음, 읽지 않음 또는 보관함으로 표시합니다.