Перейти к основному содержанию

​
Настройка сервера MCP Port

Сервер Port Model Context Protocol (MCP) обеспечивает бесшовную интеграцию с популярными средами разработки, позволяя вам получать доступ к моделям ИИ Port непосредственно из вашего редактора или IDE. В этом руководстве вы узнаете, как настроить сервер MCP с помощью различных инструментов.

​
Что такое MCP?

Model Context Protocol (MCP) — это стандартизированный способ для помощников ИИ безопасного доступа к внешним ресурсам и инструментам. Сервер MCP Port позволяет:
  • Перечислять и искать модели ИИ, доступные на Port
  • Отправлять запросы к любой конечной точке модели
  • Проверять статус и получать результаты из системы очередей
  • Загружать файлы и управлять схемами моделей
  • Беспрепятственно управлять аутентификацией API

​
Предварительные требования

Перед настройкой сервера MCP убедитесь, что у вас есть:
  1. Node.js (версия 18 или выше)
  2. Ключ API Port из вашей панели управления
  3. Установленный предпочитаемый редактор/IDE

​
Установка

Сервер MCP Port доступен в виде пакета npm: 
npm install -g @portmoda/mcp-server
Или используйте его напрямую с npx (рекомендуется): 
npx @portmoda/mcp-server

​
Конфигурация по редакторам

​
Cursor

Cursor поддерживает MCP через свой файл конфигурации. Создайте или обновите .cursor/mcp.json в корне вашего проекта: 
{
  "mcpServers": {
    "port-mcp-server": {
      "command": "npx",
      "args": ["@portmoda/mcp-server"]
    }
  }
}
Альтернативная глобальная конфигурация в ваших пользовательских настройках:
  1. Откройте настройки Cursor
  2. Перейдите в «Серверы MCP»
  3. Добавьте новый сервер с:
    • Имя: port-mcp-server
    • Команда: npx
    • Аргументы: @portmoda/mcp-server

​
VS Code

Для VS Code с поддержкой MCP (требуется совместимое расширение): Создайте .vscode/mcp.json: 
{
  "mcpServers": {
    "port-mcp-server": {
      "command": "npx",
      "args": ["@portmoda/mcp-server"],
      "env": {
        "PORT_KEY": "ваш-ключ-api-здесь"
      }
    }
  }
}

​
Cline

Cline поддерживает серверы MCP через свои настройки. Добавьте в свою конфигурацию Cline: 
{
  "mcpServers": {
    "port": {
      "command": "npx",
      "args": ["@portmoda/mcp-server"],
      "description": "Доступ к модели ИИ Port"
    }
  }
}

​
Windsurf

Для IDE Windsurf настройте MCP в настройках рабочей области: 
{
  "mcp": {
    "servers": {
      "port-mcp-server": {
        "command": "npx",
        "args": ["@portmoda/mcp-server"],
        "timeout": 30000
      }
    }
  }
}

​
Claude Desktop

Добавьте в свой файл конфигурации Claude Desktop: macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json 
{
  "mcpServers": {
    "port-mcp-server": {
      "command": "npx",
      "args": ["@portmoda/mcp-server"]
    }
  }
}

​
Другие инструменты, совместимые с MCP

Для любого другого инструмента, поддерживающего MCP, используйте этот общий шаблон конфигурации: 
{
  "mcpServers": {
    "port-mcp-server": {
      "command": "npx",
      "args": ["@portmoda/mcp-server"],
      "env": {
        "PORT_KEY": "${PORT_KEY}"
      }
    }
  }
}

​
Настройка среды

​
Установка ключа API

Вы можете настроить свой ключ API Port несколькими способами:

​
Вариант 1: переменная среды (рекомендуется)

export PORT_KEY="ваш-ключ-api-здесь"
Для Windows: 
set PORT_KEY=ваш-ключ-api-здесь

​
Вариант 2: файл конфигурации

Некоторые редакторы позволяют устанавливать переменные среды непосредственно в конфигурации MCP: 
{
  "mcpServers": {
    "port-mcp-server": {
      "command": "npx",
      "args": ["@portmoda/mcp-server"],
      "env": {
        "PORT_KEY": "ваш-ключ-api-здесь"
      }
    }
  }
}

​
Вариант 3: конфигурация во время выполнения

Сервер MCP также поддерживает установку ключа API во время выполнения с помощью инструмента set-port-key.

​
Доступные инструменты MCP

После настройки вы получите доступ к этим инструментам через своего помощника ИИ:

​
Управление моделями

  • list-models - просмотр всех доступных моделей ИИ
  • search-models - поиск моделей по ключевым словам
  • model-schema - получение схем ввода-вывода для конкретных моделей

​
Управление запросами

  • submit - отправка запросов к конечным точкам модели
  • status - проверка статуса запроса и журналов
  • result - получение завершенных результатов
  • cancel - отмена выполняемых запросов
  • subscribe - отправка и ожидание завершения

​
Управление файлами

  • upload - загрузка файлов в хранилище Port

​
Примеры использования

​
Список доступных моделей

Используйте инструмент list-models, чтобы показать мне, какие модели ИИ доступны.

​
Создание изображения

Используйте инструмент submit, чтобы создать изображение с помощью конечной точки black-forest-labs/flux-1.1-pro/text-to-image. 
Используйте подсказку: «Безмятежный горный пейзаж на закате»

​
Проверка статуса запроса

Проверьте статус запроса с идентификатором: pd_xxxxxx

​
Устранение неполадок

​
Общие проблемы

Сервер MCP не найден
  • Убедитесь, что Node.js установлен и доступен
  • Попробуйте установить глобально: npm install -g @portmoda/mcp-server
  • Убедитесь, что путь к команде указан правильно
Ошибки аутентификации
  • Убедитесь, что установлена переменная среды PORT_KEY
  • Убедитесь, что ваш ключ API действителен на панели управления Port
  • Попробуйте установить ключ с помощью инструмента set-port-key
Тайм-ауты подключения
  • Увеличьте значения тайм-аута в вашей конфигурации
  • Проверьте подключение к Интернету
  • Проверьте статус API Port
Ошибки разрешений
  • Обеспечьте надлежащие права доступа к файлам конфигурации
  • Попробуйте запустить с соответствующими правами пользователя

​
Получение помощи

Если у вас возникли проблемы:
  1. Проверьте документацию Port
  2. Просмотрите документацию MCP вашего редактора
  3. Сообщите о проблеме на GitHub

​
Следующие шаги

После настройки сервера MCP:
  1. Изучите модели: используйте list-models, чтобы увидеть все доступные возможности ИИ
  2. Попробуйте примеры: начните с простых генераций текста в изображение или текста в видео
  3. Создайте рабочие процессы: объедините несколько моделей для сложных конвейеров ИИ
  4. Отслеживайте использование: отслеживайте использование API на панели управления Port
Интеграция MCP позволяет легко встраивать мощные модели ИИ непосредственно в ваш рабочий процесс разработки, обеспечивая быстрое прототипирование и бесшовные функции на основе ИИ в ваших приложениях.