@yawlabs/tailscale-mcp 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +31 -7
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -23,23 +23,47 @@ Other Tailscale MCP servers were vibe-coded in a weekend and abandoned. This one
23
23
 
24
24
  ## Quick start
25
25
 
26
- Add to your MCP client config:
26
+ **1. Set your API key**
27
+
28
+ Get an API key from [Tailscale Admin Console > Settings > Keys](https://login.tailscale.com/admin/settings/keys) and add it to your shell profile (`~/.bashrc`, `~/.zshrc`, or system environment variables):
29
+
30
+ ```bash
31
+ export TAILSCALE_API_KEY="tskey-api-..."
32
+ ```
33
+
34
+ **2. Create `.mcp.json` in your project root**
35
+
36
+ macOS / Linux / WSL:
27
37
 
28
38
  ```json
29
39
  {
30
40
  "mcpServers": {
31
41
  "tailscale": {
32
42
  "command": "npx",
33
- "args": ["-y", "@yawlabs/tailscale-mcp"],
34
- "env": {
35
- "TAILSCALE_API_KEY": "tskey-api-..."
36
- }
43
+ "args": ["-y", "@yawlabs/tailscale-mcp"]
44
+ }
45
+ }
46
+ }
47
+ ```
48
+
49
+ Windows:
50
+
51
+ ```json
52
+ {
53
+ "mcpServers": {
54
+ "tailscale": {
55
+ "command": "cmd",
56
+ "args": ["/c", "npx", "-y", "@yawlabs/tailscale-mcp"]
37
57
  }
38
58
  }
39
59
  }
40
60
  ```
41
61
 
42
- Get your API key from [Tailscale Admin Console > Settings > Keys](https://login.tailscale.com/admin/settings/keys).
62
+ > **Tip:** This file is safe to commit it contains no secrets. Teammates who set their own `TAILSCALE_API_KEY` will get the MCP server automatically.
63
+
64
+ **3. Restart and approve**
65
+
66
+ Restart Claude Code (or your MCP client) and approve the Tailscale MCP server when prompted.
43
67
 
44
68
  That's it. Now ask your AI assistant:
45
69
 
@@ -67,7 +91,7 @@ Pulls the audit log so you can see exactly who did what and when.
67
91
 
68
92
  ## Authentication
69
93
 
70
- **API key (recommended):** Set `TAILSCALE_API_KEY`. Simplest option, works immediately.
94
+ **API key (recommended):** Set `TAILSCALE_API_KEY` in your shell profile. Simplest option, works immediately. You can also pass it inline via the `"env"` field in your MCP config if you prefer a self-contained setup.
71
95
 
72
96
  **OAuth (scoped access):** For fine-grained permissions, set `TAILSCALE_OAUTH_CLIENT_ID` and `TAILSCALE_OAUTH_CLIENT_SECRET` instead. Create an OAuth client at [Tailscale Admin Console > Settings > OAuth](https://login.tailscale.com/admin/settings/oauth).
73
97
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@yawlabs/tailscale-mcp",
3
- "version": "0.2.0",
3
+ "version": "0.2.1",
4
4
  "description": "Tailscale MCP server for managing your tailnet from AI assistants",
5
5
  "license": "MIT",
6
6
  "author": "YawLabs <contact@yaw.sh>",