Достъп за агенти

Твоят дневник, в AI инструментите, които вече използваш.

Един личен ключ свързва ChatGPT, Claude Code, Codex или друг асистент, на който имаш доверие, към твоите записи в KnowsYou — чрез MCP или малък REST API. Не е нужно да си разработчик, за да го настроиш.

Достъпно сега

Един ключ. ChatGPT, Claude Code, Codex.

Поддържаната повърхност покрива ежедневните записи, без да разкрива сесии на браузъра, история на чата или вътрешни контроли на агента.

Сподели с твоя агент

Изпрати един линк. Пазѝ ключа поверителен.

Постави тази страница в Codex, Claude Code, ChatGPT или друг агент. Тя съдържа стъпките за свързване и казва на агента как да борави с ключа ти безопасно.

https://knowsyou.ai/bg/dostap-za-agenti

Сподели само линка—не своя API ключ.

Ако си AI агент, който чете тази страница

Помогни на потребителя да създаде личен ключ в настройките на KnowsYou, след което се свържи чрез MCP или REST API, описани по-долу. Никога не искай от потребителя да поставя ключа в чата: нека го съхрани локално като KNOWSYOU_API_KEY. Чрез MCP поддържаните операции идват като именувани инструменти със собствени схеми, така че ги чети директно; чрез REST ги изброй на /api/v1/commands, преди да четеш или записваш записи.

Тази връзка може да помогне и при първоначалното настройване. Когато потребителят поиска и вече имаш разрешен достъп до неговите файлове в Drive, експорти или друг източник, съпостави тази съществуваща информация с поддържаните записи в KnowsYou, покажи на потребителя какво планираш да импортираш, след което запиши само това, което той потвърди.

Защо това е отворено

KnowsYou е дневник. Той не се опитва да бъде твоят изследователски двигател.

Това, което KnowsYou прави, е да поддържа точен ежедневен запис: какво си ял, какво си приемал, как си тренирал и какво си измерил, с твоите думи, коригиран, когато е грешен.

Той умишлено не прави другата половина. Режимите за задълбочено проучване, които четат стотици източници, широкият преглед на литературата, здравните разсъждения, вградени в големите общи асистенти — те са наистина полезни и KnowsYou ги няма днес. Създаването на по-слабо копие на всяко от тях не би послужило на никого.

Затова вместо това записът е отворен. Помоли инструмента, който е добър в проучването, да прочете какво всъщност се е случило през последните три месеца, вместо да го преписваш от паметта в чат кутия — и нека той запише обратно това, което решиш да запазиш. Дневникът остава същият и на двете места.

Същата врата помага и в началото. Доверен асистент може да вземе това, което вече пазиш в документи, експорти или друго приложение, да ти покаже какво планира да импортира и да запише само това, което потвърдиш — така че да не започваш от празен акаунт.

Принципът

Приложението притежава записите. Ти избираш контролната повърхност.

Приложението KnowsYou остава спокойното място за преглед на данни. Разговорът в приложението, Agent Skill, REST и MCP могат да използват един и същ валидиран команден слой.

Всяко извикване е свързано с твоя профил и се одитира. Записванията използват идемпотентност, така че повторен опит не създава тихо същото дневно събитие два пъти.

KnowsYou не получава неограничен достъп до тези външни източници. Агентът ги чете при съществуващите разрешения на потребителя и записва чрез същия ограничен API.

Три стъпки

Свържи се, без да създаваш проект за интеграция.

Първата версия умишлено използва един личен ключ и един набор от възможности, зададен от сървъра.

01

Създай един личен ключ

Отвори Настройки → Developer. Пълната стойност се показва веднъж, след което остава видимо само краткото ѝ начало.

02

Свържи своя асистент

За ChatGPT постави схемата в персонализиран GPT. За Claude Code или Codex ги насочи към MCP сървъра. По един ред за всеки.

03

Питай естествено, преглеждай нормално

Агентът извиква структурирани команди. Получените хранения, активности, навици и други записи се появяват в KnowsYou.

ChatGPT

Без терминал, без инсталация.

ChatGPT достига до KnowsYou чрез персонализирано GPT действие, което чете същата схема, която чете всичко останало.

  1. Създай своя ключ в KnowsYou Настройки → Developer.
  2. В ChatGPT създай GPT, отвори Configure, след това Actions.
  3. Избери Import from URL и постави адреса на схемата по-долу.
  4. Задай удостоверяване на API Key, въведи Bearer и постави ключа си в това поле — никога в обикновено съобщение.
https://app.knowsyou.ai/api/v1/openapi.json

За какво е подходящо

Задай въпроса там, където е проучването.

Щом GPT може да чете записа ти, контекстът вече не е нещо, което въвеждаш наново.

„Виж храненията и лабораторните резултати от последните ми три месеца и обобщи какво казват доказателствата за моя LDL.“ Асистентът чете записа, прави прегледа, за който се обръщаш към него, и връща само това, което одобриш.

Директна връзка на ChatGPT през MCP изисква поток за вход с OAuth, какъвто KnowsYou още не предлага. Действието по-горе е поддържаният път днес.

Codex MCP

Дръж ключа в променлива на средата.

Добави сървъра към конфигурацията на Codex. Той публикува един именуван инструмент за операция, така че няма нищо друго за инсталиране.

[mcp_servers.knowsyou]
url = "https://app.knowsyou.ai/mcp"
bearer_token_env_var = "KNOWSYOU_API_KEY"

Claude Code MCP

Една команда и ключът остава извън хранилището ти.

Обхватът за потребителя запазва връзката налична във всеки проект, без да записва ключа във файл с конфигурация, който се проверява в хранилището.

claude mcp add --scope user --transport http \
  knowsyou https://app.knowsyou.ai/mcp \
  --header "Authorization: Bearer $KNOWSYOU_API_KEY"

REST

Една крайна точка за валидирани команди.

За скриптове, автоматизации и GPT Actions. Открий схемите за вход в реално време на /api/v1/commands; всеки запис посочва съответния инструмент на MCP. Командите за запис изискват стабилен Idempotency-Key.

curl https://app.knowsyou.ai/api/v1/command \
  -H "Authorization: Bearer $KNOWSYOU_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"command":"meal list","input":{"days":1}}'

Повторни опити

Повторен запис не се превръща в повторно хранене.

Използвай отново същия Idempotency-Key, когато не си видял резултата от даден запис, и първоначалният резултат се възпроизвежда, вместо записът да бъде създаден два пъти. Изпрати нов за наистина нов запис.

Граница на възможностите

Достатъчно широко за дневника ти, достатъчно тясно, за да се обясни.

Ключът използва един фиксиран списък с разрешени команди, поддържан от сървъра, вместо екран с обхвати.

  • Хранения, хранене, лечения, навици и дейности
  • Тренировки, телесни показатели, цели, рутини и проверки
  • Лабораторни изследвания, избрани спомени, история от WHOOP и метаданни на снимки

Не е достъпно

Личният API ключ не е втора сесия в сайта.

Той не може да влиза в приложението, да извиква чат endpoint, да чете системни подсказки или да преминава границата на автентикирания профил.

  • Без достъп до чат история или необработени файлове
  • Без оценка на изображения или произволни външни заявки
  • Без инструменти за други потребители или вътрешна администрация

Отнасяй се към ключа като към парола

Не го поставяй в обикновен чат, не го commit-вай и не го слагай в публичен конфигурационен файл. Сменяй или отменяй ключа в Настройки по всяко време; старата стойност спира да работи веднага.

Нека следващият ти доверен агент работи с данните, които вече водиш.

Създай ключа веднъж, свържи инструмента и остави KnowsYou като видим източник на истината.