Formul.io MCP-сервер

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

28 инструментов, сгруппированы по назначению. Инструменты только для чтения всегда безопасны; создание, изменение и удаление ограничены выданными областями доступа.

Вариант A — 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 — примеры запросов ниже.

Вариант B — 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 появятся в списке.

Вариант C — свои агенты и OAuth 2.1

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

Транспорт

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

PKCE для публичного клиента (authorization_code). Без client secret. Токен доступа живёт 1 час; 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"
  }'
# -> { "client_id": "...", "client_secret": null }

# 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
  &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"
# -> { "access_token": "...", "refresh_token": "...", "expires_in": 3600 }

# 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}'

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

Выдавайте только то, что нужно ассистенту. Каждому инструменту нужна своя область; без неё вызов отклоняется.

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

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

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