# Rock8Cloud

> One-click deployment platform. Connect a GitHub repo and Rock8Cloud builds, deploys, and runs your application with managed PostgreSQL, Dragonfly (Redis), S3-compatible storage, per-PR preview environments, and automatic SSL.

Agents can drive the platform two ways: the REST API (authenticate with a `vhk_...` API key as `Authorization: Bearer`) or the MCP server (OAuth, browser consent on first connect).

After shipping, an agent can close the loop and observe the result: read deployment status, build logs, historical runtime logs, build metrics, and AI code-review findings over the same REST API and MCP server, then fix and redeploy.

## Integration surfaces
- [Integrations manifest](https://app.rock8.cloud/.well-known/integrations.json): machine-readable surface and auth declaration
- [OpenAPI spec](https://app.rock8.cloud/api/openapi.json): REST API schema (base URL https://app.rock8.cloud/api)
- [MCP endpoint](https://app.rock8.cloud/mcp): streamable-http Model Context Protocol server
- [MCP server card](https://app.rock8.cloud/.well-known/mcp/server-card.json): MCP connect URL and OAuth metadata

## Docs
- [Your first deployment](https://docs.rock8.cloud/docs/first-deployment): connect a repo and go live
- [MCP integration](https://docs.rock8.cloud/docs/guides/mcp-integration): connect Claude Code, Cursor, and other MCP clients
- [API keys](https://docs.rock8.cloud/docs/guides/api-keys): create and scope Bearer tokens for the REST API
- [Code reviews](https://docs.rock8.cloud/docs/guides/code-reviews): AI review findings agents can read back per branch
- [Adding a database or storage](https://docs.rock8.cloud/docs/adding-a-database): provision PostgreSQL, Dragonfly, or S3
- [Environment variables](https://docs.rock8.cloud/docs/guides/environment-variables): configure and link service env vars
- [Preview deployments](https://docs.rock8.cloud/docs/guides/preview-deployments): a live URL for every pull request
- [Custom domains](https://docs.rock8.cloud/docs/guides/custom-domains): map your own domain with managed SSL
- [Plans and usage](https://docs.rock8.cloud/docs/plans-and-usage): tiers, limits, and billing
- [FAQ](https://docs.rock8.cloud/docs/faq): common questions