Claude Code, Codex и MCP
castbase подключается к агентам по протоколу MCP (streamable HTTP, без состояния). Агент получает инструменты публикации и сам загружает медиа, проверяет и ставит посты. Это те же операции, что и в REST API, поэтому правила и лимиты общие.
Подключение
Нужен API-ключ проекта. Готовые строки с подставленным ключом показываются в кабинете сразу после выпуска ключа.
Claude Code
claude mcp add --transport http castbase https://castbase.ru/mcp --header "Authorization: Bearer <ключ>"
Проверка: claude mcp list или /mcp внутри Claude Code. Ключ в заголовке нужен потому, что Claude Code в
неинтерактивном режиме (claude -p, Agent SDK) не умеет проходить OAuth; bearer-ключ работает везде.
Codex
export CASTBASE_API_KEY=<ключ>
codex mcp add castbase --url https://castbase.ru/mcp --bearer-token-env-var CASTBASE_API_KEY
То же вручную в ~/.codex/config.toml (или в проектном .codex/config.toml):
[mcp_servers.castbase]
url = "https://castbase.ru/mcp"
bearer_token_env_var = "CASTBASE_API_KEY"
Чтобы Codex знал, как пользоваться castbase, добавьте в AGENTS.md проекта короткий блок с правилами: публиковать только
через инструменты castbase, сначала вызывать validate_post, не повторять outcome_unknown вручную. Готовый блок
AGENTS.md и skill castbase для Claude Code (SKILL.md) лежат в репозитории castbase-examples, в папке agents/.
Инструменты
| Инструмент | Что делает |
|---|---|
list_channels |
каналы проекта и их статусы |
get_platform_requirements |
требования Instagram: лимиты подписи, карусели, медиа |
upload_media_from_url |
скачать медиа по публичной ссылке и получить media_id |
create_media_upload |
получить способ загрузить файл с вашей машины |
validate_post |
проверить пост без постановки в расписание |
schedule_post |
поставить пост в расписание |
get_post_status |
статус поста и его целей |
list_posts |
посты проекта |
cancel_post |
отменить пост до отправки |
Ошибки инструментов структурированы по полям (как errors[] в REST): агент видит, какое именно поле не прошло
проверку, и может исправить запрос сам. Ключи площадок через MCP не принимаются: токен Instagram агенту передавать нельзя, подключение
канала делается по ссылке на мастер в кабинете.
Подробности по инструментам
Параметры и примеры вызова каждого инструмента публикуются вместе с релизом MCP-сервера: этот раздел дополняется. Пока ориентируйтесь на справочник REST API: инструменты вызывают те же операции с теми же полями.
Если что-то не работает
401при подключении — ключ неверный или отозван: выпустите новый.- Инструменты не видны — проверьте адрес:
https://castbase.ru/mcp. 429— упёрлись в лимит запросов на ключ.