Skip to content

Commit fbde724

Browse files
committed
Say Spaces in permission copy, and match the CLI login output
The approval screens now say Spaces, and Agent access names Sell, team invites, and connected services. The MCP default scope table lists every scope a client asks for today. The sf login example matches what the CLI prints, and the --json action line goes to stderr.
1 parent e84d3ee commit fbde724

4 files changed

Lines changed: 24 additions & 20 deletions

File tree

‎content/agents/mcp-server.mdx‎

Lines changed: 11 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -39,13 +39,18 @@ By default a client asks for these scopes.
3939
|---|---|
4040
| `teams:read` | Read the teams the account belongs to |
4141
| `teams:create` | Create teams |
42-
| `spaces:read` | Read spaces, versions, and build status |
43-
| `spaces:write` | Create and update spaces and their settings |
44-
| `spaces:rename` | Rename space slugs and managed addresses |
42+
| `teams:members.write` | Invite people to teams that the account can administer |
43+
| `sell:write` | Set up Sell, enable live sales, resend downloads, and mark orders shipped |
44+
| `spaces:read` | Read Spaces, versions, and build status |
45+
| `spaces:write` | Create and update Spaces and their settings |
46+
| `spaces:rename` | Rename Space slugs and managed addresses |
47+
| `spaces:access.write` | Change who can open a Space, including making it public through its published configuration |
48+
| `versions:download` | Read files from deployment versions |
4549
| `publish:write` | Publish new immutable versions |
46-
| `domains:read` | Read domain inventory and DNS diagnostics |
47-
| `domains:write` | Attach, verify, and mutate domains and DNS records |
48-
| `offline_access` | Refresh access without another sign-in |
50+
| `domains:read` | Read Space hostnames and certificate status. Read domain registrations and DNS records when enabled |
51+
| `domains:write` | Manage Space hostnames. Start domain purchases and manage DNS records when enabled |
52+
| `oauth-apps:write` | Register and manage the team's Sign in with Spacefast apps |
53+
| `offline_access` | Refresh access without another interactive sign-in |
4954

5055
Each tool declares the scopes it needs, and clients can read them from `tools/list` before calling.
5156

‎content/agents/permissions.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Device login is covered step by step in [sign in and security](/authentication).
2222

2323
Interactive approval screens ask for two things: how much the agent may do, and where.
2424

25-
**Access.** The device page names the profile it asked for. **Read-only access** reads your teams, sites, and domains and changes nothing. **Agent access** can create and publish sites, manage domains and DNS, create teams, and use Spacefast tools. Its own limits line says it cannot delete sites, manage team members, change billing, or mint credentials.
25+
**Access.** The device page names the profile it asked for. **Read-only access** reads your teams, Spaces, and domains and changes nothing. **Agent access** can create and publish Spaces, manage their access and domains, invite team members, create teams, manage Sell, and act on the services your team connected. Its limits line says it asks you before it deletes a Space, a team admin confirms every purchase, and it can't remove team members or change roles or billing.
2626

2727
**Teams.** You pick **All teams** ("Includes teams you join or create later"), **Choose teams** with a picker, or **No team access** ("Sign-in only. This device can't touch any team").
2828

‎content/api/authentication.mdx‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -131,11 +131,11 @@ Authorization code is the flow for people, client credentials for machines. The
131131
| --- | --- |
132132
| `teams:read` | Read the teams the account belongs to. |
133133
| `teams:create` | Create teams. |
134-
| `spaces:read` | Read spaces, versions, and build status. |
135-
| `spaces:write` | Create and update spaces and their settings. |
136-
| `spaces:rename` | Rename space slugs and managed addresses. |
134+
| `spaces:read` | Read Spaces, versions, and build status. |
135+
| `spaces:write` | Create and update Spaces and their settings. |
136+
| `spaces:rename` | Rename Space slugs and managed addresses. |
137137
| `publish:write` | Publish new immutable versions. |
138-
| `spaces:publish` | Publish a version to an existing space. |
138+
| `spaces:publish` | Publish a version to an existing Space. |
139139
| `builds:trigger` | Start a build for an existing version. |
140140
| `domains:read` | Read domain inventory and DNS diagnostics. |
141141
| `domains:write` | Attach, verify, and mutate domains and DNS records. |

‎content/cli/login.mdx‎

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -33,17 +33,16 @@ sf login
3333
```
3434

3535
```text
36-
Signing in to https://api.spacefast.com.
37-
Requesting Agent access — create and publish sites, manage domains and DNS, create teams, and use Spacefast tools.
38-
Complete device login in your browser.
39-
Code: XXXX-XXXX
40-
Link: https://…/device
41-
Opened your browser.
36+
Sign in to Spacefast
37+
Opened https://…/device
38+
Code XXXX-XXXX · check it matches
39+
40+
✓ Signed in as Ada Lovelace · Acme
4241
```
4342

4443
All of that goes to stderr. Only the approving side needs a browser, so this works over SSH and in containers. When the CLI cannot open one it says so, tells you to approve the link from any device, and waits. [Sign in and security](/authentication#log-the-cli-in) has the code lifetime, the poll cadence, and the lifetime of the credential you end up with.
4544

46-
With `--json`, one line goes to stdout before the poll blocks, so an agent can hand the code to a person:
45+
With `--json`, one line goes to stderr before the poll blocks, so an agent can hand the code to a person:
4746

4847
```json
4948
{"requiresAction":{"actionType":"device_authorization","verificationUrl":"…","userCode":"…","interval":5,"expiresAt":"…"}}
@@ -53,8 +52,8 @@ With `--json`, one line goes to stdout before the poll blocks, so an agent can h
5352

5453
| `--access` | Grants |
5554
| --- | --- |
56-
| `read` | Read your teams, sites, and domains. Changes nothing. |
57-
| `agent` (default) | Create and publish sites, manage domains and DNS, create teams, and use Spacefast tools. It cannot delete sites, manage team members, change billing, or mint credentials. |
55+
| `read` | Read your teams, Spaces, and domains. Changes nothing. |
56+
| `agent` (default) | Create and publish Spaces, and manage their access and domains. Invite team members, create teams, manage Sell, and act on the services your team connected. It asks you before it deletes a Space, and a team admin confirms every purchase. It can't remove team members or change roles or billing. |
5857

5958
The approval page shows the same scopes and lets you narrow them.
6059

0 commit comments

Comments
 (0)