Formul.io MCP-сервер

Инструменты для ассистента

Инструменты сгруппированы по задачам. Инструменты чтения получают данные или выполняют расчёты без сохранения изменений; для записи нужны выданные вами разрешения.

На любом тарифе, включая Free, можно пользоваться инструментами чтения, сохранять новые рецепты через create_recipe и import_recipe, сохранять заметки рецепта через save_recipe_note и запускать импорт с проверкой. Остальные инструменты записи — update_recipe, delete_recipe, delete_recipe_note, set_recipe_dag, save_collection, delete_collection, create_ingredient и update_ingredient — требуют Pro. Каждый вызов учитывается в лимитах запросов вашего тарифа.

Claude.ai в браузере Рекомендуется · без ключа

Самый простой путь. Claude.ai сам проходит весь поток OAuth.

1. 1 Откройте claude.ai и перейдите в Settings → Connectors.
2. 2 Нажмите Add custom connector.
3. 3 Назовите его Formul.io и вставьте адрес MCP-сервера ниже. Поля OAuth Client ID и Secret оставьте пустыми — они определяются автоматически.
4. 4 Нажмите Add. Claude.ai перенаправит вас на Formul.io для авторизации.
5. 5 Войдите, если потребуется, проверьте запрашиваемые разрешения и нажмите Allow.
6. 6 Начните новый чат и спросите Formul.io — примеры запросов ниже.

Claude Desktop API-ключ

Для Claude Desktop или любого клиента со статическим bearer-токеном.

1. Создайте API-ключ

Войдите в Formul.io, откройте Settings → Security и создайте API-ключ. Выберите только нужные разрешения:

• Запуск расчётов рецептур
• Чтение ваших рецептов
• Создание и изменение рецептов
• Поиск по базе ингредиентов
• Создание и изменение ингредиентов
• Диагностика проблем рецепта

2. Добавьте его в конфигурацию

Отредактируйте claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "formulio": {
      "url": "https://api.formul.io/mcp",
      "headers": {
        "Authorization": "Bearer fio_YOUR_KEY_HERE"
      }
    }
  }
}

Перезапустите Claude Desktop — инструменты Formul.io появятся в списке.

ChatGPT

Для собственного подключения включите Developer mode в Settings → Security and login, если это разрешено вашим аккаунтом или рабочим пространством. Откройте ChatGPT Plugins, нажмите + и добавьте адрес MCP, указанный выше. Войдите в Formul.io, проверьте разрешения и добавьте подключение в новый диалог.

Свои агенты и OAuth 2.1

Для собственного MCP-клиента или программного доступа. Аутентификация по API-ключу (Bearer fio_…) или токену доступа OAuth 2.1.

Транспорт

Конечные точки OAuth 2.1

Используйте authorization_code с PKCE S256. Issuer: https://api.formul.io. Resource: https://api.formul.io/mcp — передавайте его в запросах authorize, token и refresh. Метод аутентификации публичного клиента — none. Токен доступа живёт 15 минут; каждое обновление заменяет прежнюю пару и начинает новый 30-дневный срок refresh-токена.

Быстрый старт

# 1. Register your client once
curl -X POST https://api.formul.io/api/v1/oauth/register \
  -H "Content-Type: application/json" \
  -d '{
    "client_name": "My App",
    "redirect_uris": ["https://myapp.example.com/callback"],
    "grant_types": ["authorization_code", "refresh_token"],
    "scope": ["calculate", "recipes:read", "ingredients:read"]
  }'
# Save the returned client_id. This is a public client with no client secret.

# 2. Send the user to authorize (PKCE, S256)
https://app.formul.io/oauth/authorize
  ?client_id=YOUR_CLIENT_ID
  &redirect_uri=https://myapp.example.com/callback
  &response_type=code
  &scope=calculate+recipes:read+ingredients:read
  &code_challenge=BASE64URL(SHA256(code_verifier))
  &code_challenge_method=S256
  &resource=https%3A%2F%2Fapi.formul.io%2Fmcp
  &state=RANDOM_STATE

# 3. Exchange the code for tokens
curl -X POST https://api.formul.io/api/v1/oauth/token \
  -d "grant_type=authorization_code" \
  -d "code=AUTH_CODE" \
  -d "redirect_uri=https://myapp.example.com/callback" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "code_verifier=YOUR_VERIFIER" \
  --data-urlencode "resource=https://api.formul.io/mcp"
# -> { "access_token": "...", "refresh_token": "...", "expires_in": 900 }

# 4. Call the MCP server
curl -X POST https://api.formul.io/mcp \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Ваши данные и подключённые ассистенты

Ассистент получает данные рецептов, ингредиентов, коллекций и расчётов, которые возвращают вызванные им инструменты в пределах выданных разрешений. Полученная копия обрабатывается по его политике конфиденциальности. Отключите интеграцию в настройках ассистента, чтобы прекратить её использование; ключи API можно отозвать в Formul.io: Настройки → Безопасность. Отключение не удаляет копии, уже полученные ассистентом.

Области доступа

Выдавайте только необходимые разрешения. Если инструменту потребуется дополнительный доступ, клиент сможет запросить ваше согласие, сохранив прежние разрешения. Ограничения подписки действуют отдельно от разрешений OAuth.

Попробуйте после подключения

Ассистент работает с вашим собственным аккаунтом.

Решение проблем