Свързване на Claude с Nordlet

Това ръководство е предназначено за потребители, които искат да използват Claude за работа със своето счетоводство в Nordlet. Claude се свързва с MCP сървъра на Nordlet на адрес https://api.nordlet.com/mcp. Връзката се разрешава еднократно през страница в Nordlet. Не е необходимо да копирате ключове.

1. Създайте профил в Nordlet

1. Отворете app.nordlet.com и въведете своя имейл адрес.
2. Приемете Общите условия, Политиката за поверителност и Споразумението за обработване на данни. Nordlet ще ви изпрати линк за влизане. Линкът е валиден 15 минути и може да бъде използван веднъж. Парола не се изисква.
3. Отворете линка. Изберете абонаментен план: фиксиран месечен план, който започва с безплатен пробен период, или плащане на заявка с първоначално зареждане на баланс.
4. Създайте своето дружество: въведете име, държава, регистрационен номер и VAT номер (номер по ДДС). Ако искате първо да тествате системата, поставете отметка на Тестово дружество (Sandbox company). Тестовото дружество съдържа примерни данни и може да бъде изтрито по всяко време.

Можете да членувате в множество дружества - собствени такива, както и такива, към които сте били поканени. Вашата роля във всяко дружество (собственик, администратор, счетоводител, мениджър, програмист или потребител с права за преглед) определя действията, които можете да извършвате. Claude наследява същите права.

2. Свържете Claude

1. В Claude добавете потребителски конектор (connector) с адрес https://api.nordlet.com/mcp. Оставете полетата за удостоверяване (authentication) празни.
2. Claude ще отвори страница на Nordlet. Ако не сте влезли в системата, Nordlet ще поиска вашия имейл адрес и ще ви изпрати линк за влизане. Отворете линка в същия браузър, за да се върнете обратно към страницата.
3. На страницата са изписани името на приложението, което изисква достъп, и адресът, към който ще бъдете върнати. Проверете ги и изберете Разрешаване (Allow). Бутонът Забраняване (Deny) ви връща обратно без предоставяне на достъп.
4. Вече сте обратно в Claude и конекторът е свързан.

Claude подновява достъпа си автоматично. Токенът за достъп (access token) е валиден един час, след което Claude го подменя с нов без ваша намеса.

3. Свържете Claude Code

Изпълнете следната команда:

claude mcp add --transport http nordlet https://api.nordlet.com/mcp

След това въведете /mcp в Claude Code и изберете удостоверяване на сървъра nordlet. Вашият браузър ще отвори същата страница на Nordlet както в стъпка 2. След като изберете Разрешаване (Allow), браузърът ще ви върне обратно в Claude Code на вашия компютър.

4. Работете във вашите дружества

Една връзка важи за всяко дружество, в което членувате. Claude първо извлича списък с вашите дружества, след което поименно посочва дружеството при всяка заявка. Уточнявайте дружеството по име, например „издай тази фактура в UAB Pavyzdys“. Когато бъдeте добавени към ново дружество, Claude може да започне работа в него незабавно. Ако бъдете премахнати от дружество, Claude губи достъп до него.

Всяко извикване от страна на Claude представлява обикновена API заявка и се таксува като всяка друга заявка. Промените, които извършва, се записват в одитния журнал (audit log).

5. Прекъсване на връзката

1. В Nordlet отворете Меню с потребителски профил (Account) -> Разработчици (Developers). Връзката е налична сред вашите API ключове под името на приложението, например „Claude“.
2. Изберете Отмяна (Revoke). Claude губи достъп незабавно, във всички дружества.

За да свържете приложението отново, повторете стъпка 2.

Алтернативен вариант с API ключ

Собствениците, администраторите и програмистите могат да създадат API ключ в меню Меню с потребителски профил (Account) -> Разработчици (Developers) и да го подават като HTTP заглавка (header). Вижте MCP сървър.