Homespun — MCP-сервер для Claude Code: что делает и как установить
Разворачивает многопользовательские веб-приложения прямо из диалога с агентом: с хостингом, базой данных и авторизацией по волшебным ссылкам.
claude mcp add --transport http homespun https://homespun.dev/mcpЧто делает Homespun
MCP-сервер связывает ассистента с платформой Homespun. Агент передаёт разметку HTML и манифест возможностей через инструмент deploy_app, получая готовый публичный URL с базой данных, разграничением ролей и файловым хранилищем.
Вся информация хранится в коллекциях записей с поддержкой версионирования для оптимистичных блокировок. Изменения отслеживаются через вызовы get_feed_events и list_rows, а управление участниками и доменами собрано в отдельные инструменты с обязательным параметром action.
Для запуска исполняемого файла homespun-mcp требуется среда Node.js версии не ниже 20. При первом запуске сервер автоматически регистрирует ключ агента и сохраняет его в файл ~/.config/homespun/config.json, разделяя профиль с консольной утилитой.
Какие задачи решает
- Развернуть веб-интерфейс на отдельном URL без настройки инфраструктуры
- Настроить доступ пользователей по ролям и вход по волшебной ссылке
- Записывать и обновлять строки в коллекциях через
add_rowиupdate_row - Отслеживать правки пользователей с помощью опроса ленты
get_feed_events
Примеры запросов агенту
- Разверни веб-приложение из файла
index.htmlи привяжи к нему манифест - Добавь новую строку в коллекцию задач через инструмент
add_row - Проверь свежие изменения в ленте приложения с помощью
get_feed_events
Как установить Homespun
1Командой платформы: удалённый сервер
claude mcp add --transport http homespun https://homespun.dev/mcp2Командой платформы
claude mcp add --env HOMESPUN_API_KEY=<HOMESPUN_API_KEY> --env HOMESPUN_URL=<HOMESPUN_URL> --env HOMESPUN_AGENT_NAME=<HOMESPUN_AGENT_NAME> --env HOMESPUN_REGISTER_SECRET=<HOMESPUN_REGISTER_SECRET> --transport stdio mcp -- npx -y @homespunapps/mcpВместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
codex mcp add mcp --url https://homespun.dev/mcp2Командой платформы
codex mcp add mcp --env HOMESPUN_API_KEY=<HOMESPUN_API_KEY> --env HOMESPUN_URL=<HOMESPUN_URL> --env HOMESPUN_AGENT_NAME=<HOMESPUN_AGENT_NAME> --env HOMESPUN_REGISTER_SECRET=<HOMESPUN_REGISTER_SECRET> -- npx -y @homespunapps/mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp": {
"url": "https://homespun.dev/mcp"
}
}
}{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@homespunapps/mcp"
],
"env": {
"HOMESPUN_API_KEY": "<HOMESPUN_API_KEY>",
"HOMESPUN_URL": "<HOMESPUN_URL>",
"HOMESPUN_AGENT_NAME": "<HOMESPUN_AGENT_NAME>",
"HOMESPUN_REGISTER_SECRET": "<HOMESPUN_REGISTER_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp": {
"type": "http",
"url": "https://homespun.dev/mcp"
}
}
}{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@homespunapps/mcp"
],
"env": {
"HOMESPUN_API_KEY": "<HOMESPUN_API_KEY>",
"HOMESPUN_URL": "<HOMESPUN_URL>",
"HOMESPUN_AGENT_NAME": "<HOMESPUN_AGENT_NAME>",
"HOMESPUN_REGISTER_SECRET": "<HOMESPUN_REGISTER_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
gemini mcp add -t http mcp https://homespun.dev/mcp2Командой платформы
gemini mcp add -e HOMESPUN_API_KEY=<HOMESPUN_API_KEY> -e HOMESPUN_URL=<HOMESPUN_URL> -e HOMESPUN_AGENT_NAME=<HOMESPUN_AGENT_NAME> -e HOMESPUN_REGISTER_SECRET=<HOMESPUN_REGISTER_SECRET> mcp npx -y @homespunapps/mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Homespun
Как установить Homespun в Claude Code?
Подключите удалённый сервер одной командой в терминале: claude mcp add --transport http homespun https://homespun.dev/mcp.
Что нужно подготовить перед запуском Homespun?
Для локального запуска через stdio необходима среда Node.js версии 20 или новее. Ключ API создавать вручную не требуется: сервер зарегистрирует агента сам при первом вызове.
Как агент отслеживает правки пользователей в базе данных?
Протокол MCP работает по схеме «запрос — ответ», поэтому агент опрашивает инструмент get_feed_events с курсором от предыдущего ответа либо включает длительный опрос с параметром wait до 30 секунд.
