Bump version to 0.2.0 and restructure README for better user experience

- Increment version from 0.1.0 to 0.2.0 reflecting major FastMCP 2.0 upgrade
- Reorder README sections: client integrations first, deployment modes after
- Update transport references from "sse" to "http"
- Make deployment section more generic (remove specific cloud provider references)
- Add comprehensive deployment modes documentation with authentication patterns
- Document Bearer token authentication for remote deployments
- Add health check endpoint usage examples

Ready for v0.2.0 release with dual-mode authentication support.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: IvanBiruk

README.md

@@ -114,9 +114,9 @@ The following environment variables are supported:
 ### Command Line Options
 
 *   `--api-key`: Your CodeAlive API key. Overrides the `CODEALIVE_API_KEY` environment variable.
-*   `--transport`: Transport type: `"stdio"` (default) or `"sse"`.
-*   `--host`: Host address for SSE transport (default: `0.0.0.0`).
-*   `--port`: Port for SSE transport (default: `8000`).
+*   `--transport`: Transport type: `"stdio"` (default) or `"http"`.
+*   `--host`: Host address for HTTP transport (default: `0.0.0.0`).
+*   `--port`: Port for HTTP transport (default: `8000`).
 *   `--debug`: Enable debug mode with verbose logging to standard output/error.
 
 ## Integrating with AI Clients
@@ -388,6 +388,38 @@ If you prefer not to use `uv`, you can invoke the server script directly using t
 }
 ```
 
+## Deployment Modes
+
+The CodeAlive MCP server supports two deployment modes with different authentication patterns:
+
+### Local Development (STDIO Mode)
+For local development and Claude Desktop integration:
+```bash
+# Requires CODEALIVE_API_KEY environment variable
+export CODEALIVE_API_KEY="your_api_key_here"
+python src/codealive_mcp_server.py --transport stdio
+```
+
+### Remote Deployment (HTTP Mode)
+For remote deployment and web-based integrations:
+```bash
+# No environment variable required - uses Bearer token authentication
+python src/codealive_mcp_server.py --transport http --host 0.0.0.0 --port 8000
+
+# Client calls with Authorization header:
+curl -H "Authorization: Bearer your_api_key_here" \
+     -H "Content-Type: application/json" \
+     -X POST https://your-server.com/mcp/ \
+     -d '{"method": "tools/list"}'
+
+# Health check endpoint:
+curl https://your-server.com/health
+```
+
+**Key Differences:**
+- **STDIO mode**: Uses environment variable for API key, suitable for local/desktop clients
+- **HTTP mode**: Requires `Authorization: Bearer` header per request, suitable for web/remote clients
+
 ## Troubleshooting
 
 If the MCP server isn't working correctly with your AI client, follow these steps:

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codealive-mcp"
-version = "0.1.0"
+version = "0.2.0"
 description = "MCP server for the CodeAlive API"
 readme = "README.md"
 requires-python = "~=3.11.0"