MCP сервер для Битрикс24: агент путает тулзы и выдумывает параметры

[Vvz1995]

Пилю внутренний MCP сервер, обертку над REST Битрикс24 (crm.deal.list, tasks.task.add и прочее), чтобы менеджерские хотелки типа выгрузи сделки за май и заведи по ним задачи закрывались агентом. Стек: typescript sdk 1.x, транспорт stdio, подключаю в Claude Code.

Сделал 38 тулзов, почти 1 к 1 по методам битрикса. И начались чудеса: агент зовет crm_deal_update когда надо crm_deal_list, выдумывает несуществующий параметр filter_date_from (в битриксе фильтр это объект filter с ключами вида >=DATE_CREATE, да, я в курсе что это боль), путает ID воронок.

Схемы у всех тулзов есть, описания писал по доке. Куда копать? Кто оборачивал толстые API, как боролись?

[kingpaul]

38 тулзов это сам себе злобный буратино. дефиниции жрут контекст, и модель плывет в выборе. сократи до 6-8 смысловых: deals_search, deals_update, tasks_create и так далее, а битриксовые тонкости прячь внутри сервера. агенту нужен интерфейс для человека, а не зеркало битрикса

[basedgoblin]

@kingpaul, filter с ключами >=DATE_CREATE это самое битриксовое, что я читал за неделю. сочувствую

[nginxsmith]

агенту нужен интерфейс для человека, а не зеркало битрикса

подпишусь, и добавлю конкретики. раз агент выдумывает filter_date_from, значит твоя схема это позволяет. сделай в inputSchema честные поля date_from и date_to строками, additionalProperties false, а в >=DATE_CREATE конвертируй сам внутри тулзы. модель выдумывает параметры ровно тогда, когда настоящие неудобные. и в description пиши не что метод делает по доке, а когда его звать и когда НЕ звать. одно это убирает половину путаницы с deal_update против deal_list.

[stuartng]

@Vvz1995, про ID воронок: агент не телепат, он не знает что воронка 7 это у вас опт. либо захардкодь маппинг в описание тулзы, либо сделай list_pipelines и упомяни ее в описании deals_search, мол сначала дерни это. у меня на обертке вокруг амо так же лечилось