Ошибки JSON в конфигурации MCP: как исправить распространённые ошибки

Невалидный JSON в вашем конфигурационном файле MCP не позволит серверам загрузиться. Это руководство, ориентированное на ошибки, показывает, как выявлять и исправлять распространённые ошибки синтаксиса JSON, ошибки схемы и проблемы форматирования — с примерами того, что не так и как это исправить.

Распространённые ошибки JSON

Это наиболее частые ошибки, которые ломают конфигурационные файлы MCP:

Ошибка 1: Завершающие запятые

Невалидно (завершающая запятая)

{
  "mcpServers": {
    "workify": {
      "url": "https://app.workify.ru/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      },  ← Завершающая запятая здесь!
    }
  }
}

Валидно (без завершающей запятой)

{
  "mcpServers": {
    "workify": {
      "url": "https://app.workify.ru/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Ошибка 2: Отсутствующие кавычки

Невалидно (ключи без кавычек)

{
  mcpServers: {  ← Отсутствуют кавычки
    workify: {   ← Отсутствуют кавычки
      url: "https://app.workify.ru/mcp",
      headers: {
        Authorization: "Bearer YOUR_API_KEY"
      }
    }
  }
}

Валидно (все ключи в кавычках)

{
  "mcpServers": {
    "workify": {
      "url": "https://app.workify.ru/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Ошибка 3: Неправильная вложенность

Невалидно (несоответствие скобок)

{
  "mcpServers": {
    "workify": {
      "url": "https://app.workify.ru/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }  ← Отсутствует закрывающая скобка
  }  ← Отсутствует закрывающая скобка
}

Валидно (правильная вложенность)

{
  "mcpServers": {
    "workify": {
      "url": "https://app.workify.ru/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Ошибка 4: Комментарии в JSON

Невалидно (JSON не поддерживает комментарии)

{
  // Это комментарий — не разрешён!
  "mcpServers": {
    "workify": {
      "url": "https://app.workify.ru/mcp",  /* Ещё один комментарий */
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Валидно (без комментариев)

{
  "mcpServers": {
    "workify": {
      "url": "https://app.workify.ru/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Ошибка 5: Одинарные кавычки вместо двойных

Невалидно (одинарные кавычки)

{
  'mcpServers': {  ← Одинарные кавычки
    'workify': {
      'url': 'https://app.workify.ru/mcp',
      'headers': {
        'Authorization': 'Bearer YOUR_API_KEY'
      }
    }
  }
}

Валидно (двойные кавычки)

{
  "mcpServers": {
    "workify": {
      "url": "https://app.workify.ru/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Проблемы форматирования заголовков

Распространённые ошибки при форматировании заголовка Authorization:

Ошибка: Отсутствует префикс "Bearer "

Невалидно (нет префикса Bearer)

{
  "mcpServers": {
    "workify": {
      "url": "https://app.workify.ru/mcp",
      "headers": {
        "Authorization": "YOUR_API_KEY"  ← Отсутствует "Bearer "
      }
    }
  }
}

Валидно (с префиксом Bearer)

{
  "mcpServers": {
    "workify": {
      "url": "https://app.workify.ru/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"  ← Правильный формат
      }
    }
  }
}

Ошибка: Лишние пробелы или переносы строк

Невалидно (лишние пробелы)

{
  "mcpServers": {
    "workify": {
      "url": "https://app.workify.ru/mcp",
      "headers": {
        "Authorization": "Bearer  YOUR_API_KEY"  ← Лишний пробел
      }
    }
  }
}

Валидно (правильные пробелы)

{
  "mcpServers": {
    "workify": {
      "url": "https://app.workify.ru/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"  ← Одинарный пробел после "Bearer"
      }
    }
  }
}

Ошибки валидации схемы

Даже валидный JSON может содержать ошибки схемы, если структура не соответствует требованиям MCP:

Ошибка: Отсутствуют обязательные поля

Невалидно (отсутствует URL)

{
  "mcpServers": {
    "workify": {
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
      ← Отсутствует поле "url"
    }
  }
}

Ошибка: Неправильные имена полей

Невалидно (неправильное имя поля)

{
  "mcpServers": {
    "workify": {
      "endpoint": "https://app.workify.ru/mcp",  ← Должно быть "url"
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Пример рабочей конфигурации Workify

Вот полный рабочий конфигурационный файл для Workify MCP:

Полная рабочая конфигурация

{
  "mcpServers": {
    "workify": {
      "url": "https://app.workify.ru/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Замените YOUR_API_KEY на ваш реальный API-ключ Workify.

Несколько серверов MCP

Если у вас несколько серверов MCP, добавьте их в ту же конфигурацию:

{
  "mcpServers": {
    "workify": {
      "url": "https://app.workify.ru/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_WORKIFY_API_KEY"
      }
    },
    "other-server": {
      "url": "https://other-server.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_OTHER_API_KEY"
      }
    }
  }
}

Как проверить ваш JSON

Перед сохранением конфигурационного файла проверьте синтаксис JSON:

Онлайн-валидаторы

JSONLint — вставьте свой JSON и проверьте
JSON Formatter — форматирование и проверка
JSON Formatter & Validator — подробные сообщения об ошибках

Командная строка (macOS/Linux)

python3 -m json.tool config.json

Это проверит и красиво отформатирует ваш JSON или покажет ошибку, если он невалиден.

VS Code

VS Code автоматически проверяет JSON-файлы. Невалидный JSON будет отмечен красными волнистыми линиями и сообщениями об ошибках.

Чек-лист быстрого исправления

Перед сохранением конфигурации

✅ Все ключи в двойных кавычках
✅ Нет завершающих запятых
✅ Все скобки и фигурные скобки согласованы
✅ Нет комментариев (// или /* */)
✅ Заголовок Authorization имеет префикс "Bearer " с одним пробелом
✅ Поле URL присутствует и корректно
✅ JSON проходит проверку в онлайн-валидаторе

Связанное устранение неполадок

Claude Desktop: сервер не отображается — исправьте проблемы, когда сервер MCP не появляется
Ошибка подключения — диагностируйте проблемы сети и подключения
Индекс устранения неполадок — просмотрите все руководства по устранению неполадок