initial-commit (#1)

Reviewed-on: #1
Co-authored-by: Timo Behrendt <t.behrendt@t00n.de>
Co-committed-by: Timo Behrendt <t.behrendt@t00n.de>

README.md

@@ -1,2 +1,37 @@
-# outline-mcp
+# Outline MCP
 
+[Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server wrapping the [Outline HTTP API](https://www.getoutline.com/developers). Tools will be added as needed.
+
+## Run
+
+Use docker image pushed to https://gitea.t000-n.de/t.behrendt/outline-mcp:latest
+
+Required Environment variables:
+
+- OUTLINE_BASE_URL=https:/example.com/api
+- OUTLINE_API_KEY=xx_api_xx
+
+The server will start on port 3000.
+
+## Integrate into Claude
+
+Use [mcp-remote](https://www.npmjs.com/package/mcp-remote) as this currently works best with Claude Desktop. Change the URL to wherever your MCP server runs and adjust authentication according to the package. Refer to the [Claude Desktop MCP documentation](https://modelcontextprotocol.io/quickstart/user) for a deeper dive.
+
+```json
+{
+  "mcpServers": {
+    "outline": {
+      "command": "npx",
+      "args": ["mcp-remote", "http://localhost:3000/mcp"]
+    }
+  }
+}
+```
+
+## Test
+
+Use the [mcp inspector](https://www.npmjs.com/package/@modelcontextprotocol/inspector) to view tools and run tests.
+
+```bash
+bunx @modelcontextprotocol/inspector
+```