linkedin-mcp

MCP-сервер для редактирования вашего собственного профиля LinkedIn из Claude Code — с жёстким разделением «сначала предложение, затем подтверждение»: модель может подготовить черновик изменения и показать вам diff, но записывать умеет только один инструмент, и он действует исключительно по предложению, которое вы видели.

Ограничение для партнёров: API редактирования профиля LinkedIn (Profile Edit API) доступно только одобренным партнёрам-разработчикам (w_compliance — «это приватное разрешение, доступ предоставляется избранным разработчикам» — см. docs/api-notes.md). Пока не получено партнёрское одобрение, apply_proposal возвращает ошибку invalid-scope. Это ожидаемое поведение, а не дефект. Всё остальное — OAuth, предложения, diff — уже работает.

Как это работает

Предложения сохраняются в ~/.config/linkedin-mcp/proposals/, поэтому подтвердить их можно в последующей сессии. Токены и учётные данные клиента лежат в ~/.config/linkedin-mcp/.env с правами доступа 600 — их вводите вы сами, никогда не агент, и они никогда не попадают в коммиты (см. .env.example).

Related MCP server: kaushik-linkedin-mcp

Установка

Требуется Python ≥ 3.11.

{
  "mcpServers": {
    "linkedin": {
      "command": "bash",
      "args": ["/path/to/linkedin-mcp/run.sh"]
    }
  }
}

run.sh создаёт .venv/ и устанавливает зафиксированные зависимости при первом запуске (переключение по маркеру-файлу; весь вывод инициализации идёт в stderr, сохраняя канал MCP stdio чистым).

Настройка

Следуйте docs/SETUP-KYLE.md — он последовательно описывает создание приложения LinkedIn Developer, регистрацию redirect URL, заполнение ~/.config/linkedin-mcp/.env, запуск auth_start и подачу заявки на партнёрскую программу.

Разработка

bash run.sh --help                                # bootstraps the venv (runtime deps only)
.venv/bin/pip install -r requirements-dev.txt     # adds pytest + coverage tooling
.venv/bin/python -m pytest                        # offline — every test runs against a mock transport

В тестовом наборе есть фикстура c разрешением на запись: имитация LinkedIn, где каждый документированный эндпоинт записи с готовностью возвращает 200. Тесты проверяют, что propose_edit не оставляет в журнале ни одного не-GET-запроса, даже там, где запись прошла бы успешно, и (положительный контроль) что apply_proposal фиксирует документированный вызывающий запись — в том же фикстуре. --live-probe — диагностический флаг (один реальный запрос, отличает «endpoint правильный, но scope не выдан» от «endpoint ошибочный»); он никогда не выполняется в тестах или CI и требует LINKEDIN_MCP_LIVE_PROBE=1.

Поверхность API привязана к датированным досовним выдерккам из официальной документации в docs/api-notes.md.

Лицензия

MIT — см. LICENSE.