
Instagram MCP: публикации, комментарии и статистика через агента
Подключает агента к Instagram: публиковать посты, рилсы и сторис, отвечать на комментарии, читать статистику своего бизнес-аккаунта или собирать открытые профили и ленты чужих аккаунтов.
Работает через Instagram Graph API с вашим токеном: публикация, комментарии, статистика, несколько аккаунтов.
Как подключить
Что сделать до подключения
Python 3.10 или новее
pip install adelaidasofia-instagram-mcp
Профессиональный аккаунт Instagram (Business или Creator), привязанный к странице Facebook
Приложение типа Business в developers.facebook.com с продуктом Instagram
INSTAGRAM_MCP_ACCESS_TOKENв Graph API Explorer выберите своё приложение, нажмите Generate Access Token, выдайте права instagram_basic, instagram_content_publish, instagram_manage_comments, instagram_manage_insights и обменяйте токен на долгоживущий, он действует около 60 дней
INSTAGRAM_MCP_IG_USER_IDзапросите у Graph API поле instagram_business_account у своей страницы Facebook: его id и есть нужное значение
Конфиг для вашего клиента
Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code
claude mcp add --env 'INSTAGRAM_MCP_ACCESS_TOKEN=<долгоживущий токен>' --env 'INSTAGRAM_MCP_IG_USER_ID=<id бизнес-аккаунта Instagram>' --transport stdio instagram \
-- instagram-mcpПроверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.instagram]
command = "instagram-mcp"
args = []
[mcp_servers.instagram.env]
INSTAGRAM_MCP_ACCESS_TOKEN = "<долгоживущий токен>"
INSTAGRAM_MCP_IG_USER_ID = "<id бизнес-аккаунта Instagram>"Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"instagram": {
"command": "instagram-mcp",
"args": [],
"env": {
"INSTAGRAM_MCP_ACCESS_TOKEN": "<долгоживущий токен>",
"INSTAGRAM_MCP_IG_USER_ID": "<id бизнес-аккаунта Instagram>"
}
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"instagram": {
"type": "stdio",
"command": "instagram-mcp",
"args": [],
"env": {
"INSTAGRAM_MCP_ACCESS_TOKEN": "<долгоживущий токен>",
"INSTAGRAM_MCP_IG_USER_ID": "<id бизнес-аккаунта Instagram>"
}
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"instagram": {
"command": "instagram-mcp",
"args": [],
"env": {
"INSTAGRAM_MCP_ACCESS_TOKEN": "<долгоживущий токен>",
"INSTAGRAM_MCP_IG_USER_ID": "<id бизнес-аккаунта Instagram>"
}
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"instagram": {
"command": "instagram-mcp",
"args": [],
"env": {
"INSTAGRAM_MCP_ACCESS_TOKEN": "<долгоживущий токен>",
"INSTAGRAM_MCP_IG_USER_ID": "<id бизнес-аккаунта Instagram>"
}
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"instagram": {
"type": "local",
"command": ["instagram-mcp"],
"environment": {
"INSTAGRAM_MCP_ACCESS_TOKEN": "<долгоживущий токен>",
"INSTAGRAM_MCP_IG_USER_ID": "<id бизнес-аккаунта Instagram>"
}
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
{
"mcpServers": {
"instagram": {
"command": "instagram-mcp",
"args": [],
"env": {
"INSTAGRAM_MCP_ACCESS_TOKEN": "<долгоживущий токен>",
"INSTAGRAM_MCP_IG_USER_ID": "<id бизнес-аккаунта Instagram>"
}
}
}
}Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"instagram": {
"command": "instagram-mcp",
"args": [],
"env": {
"INSTAGRAM_MCP_ACCESS_TOKEN": "<долгоживущий токен>",
"INSTAGRAM_MCP_IG_USER_ID": "<id бизнес-аккаунта Instagram>"
}
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
healthcheckпроверяет токен и доступadd_accountдобавляет аккаунтlist_accountsпоказывает подключённые аккаунтыget_profileчитает профильlist_mediaпоказывает публикацииget_account_insightsдаёт охват и подписчиковget_media_insightsдаёт статистику постаget_audience_insightsпоказывает демографию подписчиковpublish_imageпубликует фотоpublish_reelпубликует рилсpublish_carouselпубликует карусельpublish_storyпубликует сторисpublishing_limitпоказывает остаток квотыget_commentsчитает комментарииreply_to_commentотвечает на комментарийhide_commentскрывает комментарийsearch_hashtagищет хештегget_mentionsнаходит упоминанияbusiness_discoveryчитает чужой бизнес-аккаунтsend_messageотправляет сообщение в директПоказано 20 из 29.
Удалённый сервер только для чтения: профили, посты, рилсы и комментарии любого открытого аккаунта, без входа в Instagram.
Как подключить
Что сделать до подключения
x-api-keyключ из кабинета app.hasdata.com, регистрация без карты; бесплатно 1 000 кредитов в месяц, это 100 вызовов
Конфиг для вашего клиента
Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code
claude mcp add --transport http instagram-mcp https://mcp.hasdata.com/mcp?apis=instagram \
--header 'x-api-key: <ключ HasData>'Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.instagram-mcp]
url = "https://mcp.hasdata.com/mcp?apis=instagram"
http_headers = { "x-api-key" = "<ключ HasData>" }Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"instagram-mcp": {
"url": "https://mcp.hasdata.com/mcp?apis=instagram",
"headers": {
"x-api-key": "<ключ HasData>"
}
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"instagram-mcp": {
"type": "http",
"url": "https://mcp.hasdata.com/mcp?apis=instagram",
"headers": {
"x-api-key": "<ключ HasData>"
}
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"instagram-mcp": {
"httpUrl": "https://mcp.hasdata.com/mcp?apis=instagram",
"headers": {
"x-api-key": "<ключ HasData>"
}
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"instagram-mcp": {
"httpUrl": "https://mcp.hasdata.com/mcp?apis=instagram",
"headers": {
"x-api-key": "<ключ HasData>"
}
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"instagram-mcp": {
"type": "remote",
"url": "https://mcp.hasdata.com/mcp?apis=instagram",
"headers": {
"x-api-key": "<ключ HasData>"
}
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://mcp.hasdata.com/mcp?apis=instagram
Request headers: x-api-key: <ключ HasData>Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"instagram-mcp": {
"url": "https://mcp.hasdata.com/mcp?apis=instagram",
"headers": {
"x-api-key": "<ключ HasData>"
}
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
hasdata_instagram_profile_getInstagramProfileчитает профиль и 12 постовhasdata_instagram_posts_getInstagramPostsлистает ленту постовhasdata_instagram_reels_getInstagramReelsчитает вкладку рилсовhasdata_instagram_comments_getInstagramCommentsчитает комментарии под постомЧто попросить агента
Для каких задач
Ограничения
instagram-mcp работает только с профессиональными аккаунтами, привязанными к странице Facebook; личный аккаунт Graph API не поддерживает
Директ в instagram-mcp включается после проверки приложения в Meta (App Review), это обычно занимает недели; публикация принимает только картинки и видео по открытым https-ссылкам
HasData не публикует и не пишет комментарии, не читает сторис и директ, не ищет по хештегам; каждый вызов стоит 10 кредитов, платные тарифы от $59 в месяц
Оба проекта небольшие: у instagram-mcp 17 звёзд, у HasData — 12
Если не работает
HasData подключился, но первый вызов возвращает HasData API error: 401 Unauthorized
Подключение к HasData сразу падает с ошибкой 401
Инструменты директа в instagram-mcp возвращают ошибку с требованием проверки
По закрытому аккаунту HasData не возвращает посты
Какую реализацию выбрать
| Реализация | Кто делает | Звёзды | Запуск | Ключ | Инструменты | Обновлён |
|---|---|---|---|---|---|---|
| instagram-mcp | Adelaida Diaz-Roa | 17 | локально | токен | 29 | 28 октября 2026 |
| HasData Instagram MCP | HasData | 12 | HTTP | токен | 4 | 9 ноября 2026 |