Typeship — MCP-сервер для Claude Code: что делает и как установить
Сервер связывает агента с платформой Typeship для создания типизированных SDK, консольных утилит и MCP-серверов из схем OpenAPI и GraphQL.
claude mcp add --transport http typeship https://typeship.dev/mcpЧто делает Typeship
Typeship преобразует спецификации OpenAPI и GraphQL в готовые клиенты и кодовые базы. Сервер открывает моделям три инструмента: search_docs, read_docs и execute. Перед запуском метода агент может изучить входные параметры, примеры и уровень безопасности операции, поэтому риск ошибочных сетевых запросов минимален.
Проверка типов аргументов выполняется на месте до отправки в сеть. Некорректные параметры вернут ошибку со стабильным кодом и подсказкой next_steps. Для локальной работы через npx требуется среда Node.js не ниже 20 версии, а без переменной окружения TYPESHIP_TOKEN сервер отклонит авторизацию. Если разворачивать локальный процесс не хочется, доступен удалённый HTTP-эндпоинт.
Какие задачи решает
- сгенерировать типизированный SDK по схеме OpenAPI или GraphQL
- собрать MCP-сервер или CLI на базе спецификации API
- проверить структуру схемы и выявить ошибки валидации
- ограничить доступ агента режимом только для чтения через флаг
--read-only
Примеры запросов агенту
- Найди в документации Typeship методы для импорта спецификации OpenAPI
- Изучи аргументы операции генерации через
read_docsперед её вызовом - Собери клиентскую библиотеку по текущей схеме GraphQL
Как установить Typeship
1Командой платформы: удалённый сервер
claude mcp add --transport http typeship https://typeship.dev/mcp2Командой платформы
claude mcp add --env TYPESHIP_TOKEN=<TYPESHIP_TOKEN> --transport stdio typeship -- npx -y @typeship-ax/mcpВместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
codex mcp add typeship --url https://typeship.dev/mcp2Командой платформы
codex mcp add typeship --env TYPESHIP_TOKEN=<TYPESHIP_TOKEN> -- npx -y @typeship-ax/mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"typeship": {
"url": "https://typeship.dev/mcp"
}
}
}{
"mcpServers": {
"typeship": {
"command": "npx",
"args": [
"-y",
"@typeship-ax/mcp"
],
"env": {
"TYPESHIP_TOKEN": "<TYPESHIP_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"typeship": {
"type": "http",
"url": "https://typeship.dev/mcp"
}
}
}{
"servers": {
"typeship": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@typeship-ax/mcp"
],
"env": {
"TYPESHIP_TOKEN": "<TYPESHIP_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
gemini mcp add -t http typeship https://typeship.dev/mcp2Командой платформы
gemini mcp add -e TYPESHIP_TOKEN=<TYPESHIP_TOKEN> typeship npx -y @typeship-ax/mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Typeship
Как установить Typeship в Claude Code?
Для подключения размещённого сервера выполните claude mcp add --transport http typeship https://typeship.dev/mcp. Для локального запуска укажите токен и выполните claude mcp add --env TYPESHIP_TOKEN=<TYPESHIP_TOKEN> --transport stdio typeship -- npx -y @typeship-ax/mcp.
Что делает Typeship?
Сервер даёт агентам инструменты search_docs, read_docs и execute для обращения к сервису Typeship. С их помощью ассистент анализирует схемы API и создаёт актуальные SDK, CLI или интерфейсы MCP.
Что нужно для локального запуска сервера?
Понадобится Node.js версии 20 или новее и токен доступа в переменной TYPESHIP_TOKEN. При необходимости можно ограничить доступ флагом --read-only.
