Создать портал
Документация

Инструменты MCP-сервера портала

Каждый портал на teamportal.pro работает как MCP-сервер. Здесь адрес, подключение, права токена и все 108 инструментов, которые видит агент. Зачем это команде — на странице «ИИ-агент в портале».

Адрес и доступ

Адресhttps://<адрес-портала>/api/mcp
ТранспортHTTP (streamable HTTP протокола MCP)
Авторизациязаголовок Authorization: Bearer <токен>; токен выпускается в «Профиль → API-токены»
Праваправа пользователя, выпустившего токен, плюс галочки на токене
Лимиты60 запросов в минуту на пользователя; до 10 активных токенов; файл через MCP — до 10 МБ
Проверено наClaude Code и Codex CLI; подходит любой MCP-клиент с HTTP-транспортом

Подключение

Вместо <адрес-портала> подставьте адрес своего портала, вместо <токен> — выпущенный токен. Все три записи портал показывает рядом с токеном уже с вашим адресом: команду Claude Code — одной строкой. Здесь команда разбита на строки знаком \, а заголовок для Codex вынесен в отдельную таблицу файла — работают обе записи. Kimi Code берёт серверы из файла ~/.kimi-code/mcp.json: если файла нет, создайте его с этим текстом, если есть — добавьте запись внутрь mcpServers.

Claude Code · терминал
claude mcp add --transport http team-portal \
  https://<адрес-портала>/api/mcp \
  --header "Authorization: Bearer <токен>"
Codex CLI · ~/.codex/config.toml
[mcp_servers.team-portal]
url = "https://<адрес-портала>/api/mcp"

[mcp_servers.team-portal.http_headers]
Authorization = "Bearer <токен>"
Kimi Code · ~/.kimi-code/mcp.json
{
  "mcpServers": {
    "team-portal": {
      "url": "https://<адрес-портала>/api/mcp",
      "headers": { "Authorization": "Bearer <токен>" }
    }
  }
}

Как это выглядит

Агент сам выбирает инструменты под просьбу. В примере он вызвал search_docs, list_directions и create_task, а затем get_planner_week.

ваш ИИ-агент
Найди регламент отгрузки и поставь складу задачу обновить его после смены перевозчика.
Нашёл документ «Регламент отгрузки» в базе знаний. Создал задачу «Обновить регламент после смены перевозчика» на направлении «Склад», исполнитель — Сергей, срок — пятница.
Что у меня по плану завтра?
Три задачи и одна встреча: смета до 11:00, разбор заявок, планёрка в 10:00. После 15:00 время свободно.

Чтение: доступно с любым токеном

Агент видит то, что видит в интерфейсе пользователь, выпустивший токен. Закрытые документы, чужие личные задачи и встречи, куда пользователя не позвали, агенту не видны.

Задачи

Чтение, с любым токеном.

list_tasksзадачи доски, по умолчанию свои; фильтры по статусу, направлению, проекту, тегу и тексту
search_tasksполнотекстовый поиск по названию, описанию, комментариям и тегам; можно искать по ссылке на задачу
get_taskкарточка задачи: описание, блокировки, план в неделе, напоминания, обсуждение и файлы
list_archived_tasksархив и корзина задач: куда делась задача и кто её закрыл

База знаний

Чтение, с любым токеном.

search_docsпоиск по документам с русской морфологией и опечатками
get_documentтекст документа со связями и вложениями; длинный документ читается по разделам
list_documentsсписок документов с фильтрами по названию, типу, статусу и проекту
get_knowledge_treeдерево документов, как в проводнике базы знаний
list_document_foldersпапки базы знаний с числом документов и файлов
get_document_accessкому открыт документ
get_daily_noteваш ежедневник за дату
get_topic_entriesзаписи темы обсуждений, собранной из нескольких встреч

Файлы

Чтение, с любым токеном.

read_task_fileсодержимое файла задачи или комментария: PDF, Word, Excel, изображения
read_document_fileсодержимое вложения документа базы знаний

Встречи и договорённости

Чтение, с любым токеном.

list_eventsвстречи: предстоящие и прошедшие, с фильтрами по виду, направлению и команде
get_eventкарточка встречи: план, протокол, чат встречи, записи
list_event_typesвиды мероприятий: планёрка, встреча один на один и другие
list_agreementsдоговорённости со встреч: текст, ответственный, срок, связанная задача

Сообщения

Чтение, с любым токеном.

list_conversationsваши разговоры, свежие сверху, с числом непрочитанного
list_channelsваши каналы и каталог публичных
get_conversationразговор целиком; на просьбу «что ответили» — только новое с прошлого чтения
search_messagesпоиск по переписке с русской морфологией

Люди

Чтение, с любым токеном.

list_employeesпользователи: имя, направления, когда были в портале
list_teamsкоманды с составом и ролями
list_directionsнаправления — доски задач
list_absencesотпуска, больничные и командировки с датами

План, отчёты и аналитика

Чтение, с любым токеном.

get_planner_weekнеделя планировщика: задачи в сетке, встречи, напоминания, факт прошедших дней
get_my_weekличный срез недели: задачи, время, договорённости
get_team_dashboardсрез недели по команде с метриками каждого пользователя
get_week_rhythmритм недели: встречи процесса и плановые задачи на шкале
list_weekly_reportsкомандные недельные отчёты
get_weekly_reportтекст командного недельного отчёта
get_individual_reportваши персональные ИИ-отчёты
get_task_analyticsметрики потока задач: сколько закрыто, время выполнения, накопительная диаграмма

Проекты и цели

Чтение, с любым токеном.

list_projectsпроекты и карточка проекта с его задачами
get_goal_treeдерево целей: прогресс, покрытие планами, тренд факта по дням

Уведомления и корзина

Чтение, с любым токеном.

list_notificationsваш колокольчик: уведомления и напоминания
list_trashудалённые встречи, файлы и папки базы знаний
notify_meсообщение вам в Telegram, например «закончил длинную работу»; данных портала не меняет

Запись: по галочкам на токене

Каждый раздел открывается отдельной галочкой при выпуске токена в «Профиль → API-токены». Галочки меняются позже без перевыпуска токена. Токен без галочек только читает.

Задачи: запись

Галочка «Разрешить создание и изменение задач».

create_taskсоздать задачу на доске направления
update_taskизменить поля задачи: статус, исполнителя, срок, теги, доступ
schedule_taskрасставить задачу по слотам недели в планировщике
add_task_commentнаписать комментарий к задаче
update_task_commentпоправить свой комментарий
delete_task_commentудалить свой комментарий
create_task_from_agreementсделать задачу из договорённости встречи

База знаний: запись

Галочка «Разрешить работу с документами базы знаний».

create_documentсоздать документ
update_documentпоправить документ нужным фрагментом, не перезаписывая весь текст
duplicate_documentсделать редактируемую копию документа
archive_documentубрать документ в архив; восстанавливается из интерфейса
set_document_accessнастроить, кому открыт документ
append_daily_noteдописать текст в ваш ежедневник
attach_file_to_documentприложить файл к документу
upload_fileположить файл в раздел «Файлы»
delete_fileубрать файл в корзину
create_knowledge_folderсоздать папку

Встречи: запись

Галочка «Разрешить создание и изменение мероприятий».

create_eventназначить встречу: время, участники, план
update_eventизменить план, время или состав встречи

Сообщения: запись

Галочка «Разрешить сообщения в чат».

send_messageнаписать пользователю в личные сообщения или в канал, где вы участник
edit_messageпоправить своё сообщение
delete_messageудалить своё сообщение
create_channelзавести групповой чат
update_channel_membersдобавить или убрать участников канала
update_channelизменить название, описание и видимость канала
set_channel_member_roleназначить участнику роль администратора канала

Финансы: профиль и счета

Галочка «Разрешить ведение финансов»: без неё финансы агенту не видны даже на чтение.

get_finance_profileпрофиль учёта: личные финансы или финансы компании
set_finance_profileвыбрать профиль учёта
list_finance_accountsсчета с остатком на сегодня и датой последней операции
create_finance_accountзавести счёт
update_finance_accountизменить счёт

Финансы: статьи

Галочка «Разрешить ведение финансов».

list_finance_articlesсправочник статей движения денег
create_finance_articlesзавести статьи списком
update_finance_articleизменить статью или положить её в группу
update_finance_article_groupпереименовать группу статей
merge_finance_articlesслить статью-дубль в основную

Финансы: движения

Галочка «Разрешить ведение финансов».

list_finance_entriesдвижения денег с фильтрами и итогами
create_finance_entryзавести движение руками: наличные, трата картой
create_finance_transferперевод между своими счетами парой записей
update_finance_entryизменить движение
delete_finance_entryудалить движение

Финансы: выписки

Галочка «Разрешить ведение финансов».

preview_finance_importразобрать банковскую выписку из файла задачи или документа и показать предпросмотр
commit_finance_importзаписать разобранную выписку
rollback_finance_importоткатить загрузку выписки целиком

Финансы: разбор и правила

Галочка «Разрешить ведение финансов».

list_finance_queueочередь «Разобрать» сводкой по контрагентам
assign_finance_articleпоставить статью перечисленным записям
undo_finance_reviewвернуть записи в очередь «Разобрать»
pair_finance_transferсклеить две записи в перевод между своими счетами
unpair_finance_transferрасспарить ошибочный перевод
list_finance_rulesправила классификации
create_finance_ruleзавести правило
delete_finance_ruleудалить правило
apply_finance_rulesпрогнать правила по очереди: сначала вхолостую с числом затронутых

Финансы: контрагенты и долги

Галочка «Разрешить ведение финансов».

list_finance_counterpartiesконтрагенты с сальдо долга
create_finance_counterpartyзавести контрагента
update_finance_counterpartyизменить контрагента
merge_finance_counterpartiesслить контрагента-дубль в основного
list_finance_counterparty_adjustmentsкорректировки долга контрагента и расшифровка сальдо
create_finance_counterparty_adjustmentзавести корректировку долга
update_finance_counterparty_adjustmentизменить корректировку долга
delete_finance_counterparty_adjustmentудалить корректировку долга
settle_finance_debtпогасить долг платежом в другой валюте
unsettle_finance_debtотвязать погашение от долга

Финансы: бумаги и валюта

Галочка «Разрешить ведение финансов».

list_finance_positionsпозиции: бумаги и валюта на счетах
create_finance_positionзавести позицию
update_finance_positionизменить позицию
set_finance_valuationоценить инструмент на дату вручную

Подробнее

Права, примеры запросов и ограничения — в инструкции «MCP: подключение AI-агентов к порталу». Она приезжает в базу знаний каждого портала, а прочитать её сейчас можно в демонстрационном портале.

Перечень соответствует текущей версии портала. Новый инструмент появляется здесь вместе с обновлением.

Подключить агента к своему порталу

Портал создаётся за несколько минут на адресе вашей компании. В демо-портале токены выключены, но разделы, с которыми работает агент, открыты без регистрации.

Создать портал Попробовать демо