Skip to content

Commit d60c98d

Browse files
guide: Google
1 parent 758e903 commit d60c98d

4 files changed

Lines changed: 139 additions & 94 deletions

File tree

guides/google-people/external.md

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ setup_version: 1
44

55
# Set up Google People
66

7-
You need a Google Cloud project and access to the [Google Cloud console](https://console.cloud.google.com). To enable the People API, you need `serviceusage.services.enable`, normally through **Service Usage Admin** or **Owner**. To grant project roles, you need **Project IAM Admin**. Before you begin, have the application or security owner configure prompt and response screening for malicious content or prompt injection; Model Armor is one option.
7+
You need a Google Cloud project and access to the [Google Cloud console](https://console.cloud.google.com). To enable the People API, you need `serviceusage.services.enable`, normally through **Service Usage Admin** or **Owner**. To grant project roles, you need **Project IAM Admin**. Each connecting user must already have access to the intended Google profile, contacts, and directory data. Google documents that application developers are responsible for screening prompts and responses for malicious content or prompt injection; Model Armor is one documented option.
88

99
### Enable the People API {#enable-people-api}
1010

@@ -38,10 +38,13 @@ Google does not allow an OAuth consent screen to be removed after it is configur
3838

3939
1. Open **Google Auth platform** > **Branding**.
4040
2. If the page shows **Google Auth platform not configured yet**, click **Get Started**.
41+
42+
If Google Auth platform was already configured, retain its approved **Branding**. Retain its **Audience** only if it covers every intended connecting account. **Internal** qualifies only when all those accounts are in the Google Cloud organization associated with the project; otherwise use an approved **External** configuration. Then continue at step 14. Otherwise, complete the first-time wizard:
43+
4144
3. Under **App Information**, enter `People API MCP Server` in **App name**.
4245
4. Select a monitored **User support email**.
4346
5. Click **Next**.
44-
6. Under **Audience**, select **Internal**. If **Internal** is unavailable, select **External**.
47+
6. Under **Audience**, select **Internal** only if every intended connecting account is in the Google Cloud organization associated with the project. Otherwise, use an approved **External** configuration.
4548
7. Click **Next**.
4649
8. Under **Contact Information**, enter a monitored **Email address**.
4750
9. Click **Next**.
@@ -50,8 +53,6 @@ Google does not allow an OAuth consent screen to be removed after it is configur
5053
12. Click **Continue**.
5154
13. Click **Create**.
5255

53-
If Google Auth platform was already configured, retain its approved **Branding** and **Audience**.
54-
5556
14. Open **Data Access**.
5657
15. Click **Add or Remove Scopes**.
5758
16. Under **Manually add scopes**, paste these three scope URLs:
@@ -66,7 +67,7 @@ If Google Auth platform was already configured, retain its approved **Branding**
6667
18. Click **Update**.
6768
19. Click **Save**.
6869
69-
If you selected **External** and the app is in **Testing**, add every connecting account:
70+
An **External** app in **Testing** supports no more than 100 test users. Use this branch only when every intended connecting account fits within that ceiling:
7071
7172
20. Open **Audience**.
7273
21. Under **Test users**, click **Add users**.
@@ -101,6 +102,6 @@ Prepare an approved secret store before the next step. The next dialog allows th
101102
3. Keep both values for [connecting your credentials](speakeasy.md#connect-speakeasy-credentials).
102103
4. Return to the Speakeasy AI Control Plane.
103104
104-
If you miss the one-time secret, delete it and create a new one before continuing.
105+
If you miss the one-time secret, return to **Google Auth platform** > **Clients**. Delete the affected OAuth client using its visible or equivalent delete control. Repeat [Create the OAuth client](#create-oauth-client) and this credential-copy section before continuing.
105106
106107
<!-- screenshot-exception: do not capture a dialog containing a one-time secret -->

guides/google-people/meta.yaml

Lines changed: 19 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -25,11 +25,10 @@ credential_setup:
2525
description: A Google Cloud project where an administrator can enable the People API, grant project IAM roles, configure Google Auth platform, and create OAuth credentials
2626
- id: connecting-user-access
2727
description: Each connecting user has MCP Tool User on the project and access to the intended Google profile, contacts, and directory data
28-
- id: prompt-injection-screening
29-
description: An application or security owner has configured prompt and response screening for malicious content or prompt injection
3028
documentation:
3129
external: external.md
3230
speakeasy: speakeasy.md
31+
speakeasy_add_server: auto
3332
remotes:
3433
- id: hosted
3534
url: https://people.googleapis.com/mcp/v1
@@ -41,102 +40,90 @@ remotes:
4140
locator: https://developers.google.com/people/v1/configure-mcp-server
4241
name: Configure the People API MCP server
4342
classification: official
44-
observed_at: "2026-07-29T21:55:51Z"
45-
- source: endpoint-observation
46-
locator: https://people.googleapis.com/mcp/v1
47-
name: Google People API MCP endpoint
48-
classification: official
49-
observed_at: "2026-07-29T21:55:51Z"
43+
observed_at: "2026-08-29T15:13:24Z"
5044
- source: endpoint-observation
5145
locator: https://people.googleapis.com/.well-known/oauth-protected-resource/mcp/v1
5246
name: Google People API MCP protected-resource metadata
5347
classification: official
54-
observed_at: "2026-07-29T21:55:51Z"
48+
observed_at: "2026-08-29T15:13:24Z"
5549
provenance:
5650
- source: provider-documentation
5751
locator: https://developers.google.com/people/v1/configure-mcp-server
5852
name: Configure the People API MCP server
5953
classification: official
60-
observed_at: "2026-07-29T21:55:51Z"
54+
observed_at: "2026-08-29T15:13:24Z"
6155
- source: provider-documentation
6256
locator: https://developers.google.com/people/api/mcp
6357
name: People API MCP reference
6458
classification: official
65-
observed_at: "2026-07-29T21:55:51Z"
59+
observed_at: "2026-08-29T15:13:24Z"
6660
- source: provider-documentation
6761
locator: https://developers.google.com/workspace/guides/enable-apis
6862
name: Enable Google Workspace APIs
6963
classification: official
70-
observed_at: "2026-07-29T21:55:51Z"
64+
observed_at: "2026-08-29T15:13:24Z"
7165
- source: provider-documentation
7266
locator: https://developers.google.com/workspace/guides/configure-oauth-consent
7367
name: Configure the OAuth consent screen and choose scopes
7468
classification: official
75-
observed_at: "2026-07-29T21:55:51Z"
69+
observed_at: "2026-08-29T15:13:24Z"
7670
- source: provider-documentation
7771
locator: https://developers.google.com/workspace/guides/create-credentials
7872
name: Create access credentials
7973
classification: official
80-
observed_at: "2026-07-29T21:55:51Z"
74+
observed_at: "2026-08-29T15:13:24Z"
8175
- source: provider-documentation
8276
locator: https://developers.google.com/workspace/guides/configure-mcp-security
8377
name: Configure security for Google Workspace MCP servers
8478
classification: official
85-
observed_at: "2026-07-29T21:55:51Z"
79+
observed_at: "2026-08-29T15:13:24Z"
8680
- source: provider-documentation
8781
locator: https://docs.cloud.google.com/mcp/supported-products
8882
name: Google and Google Cloud products with MCP support
8983
classification: official
90-
observed_at: "2026-07-29T21:55:51Z"
84+
observed_at: "2026-08-29T15:13:24Z"
9185
- source: provider-documentation
9286
locator: https://docs.cloud.google.com/mcp/set-up-authentication-mcp-servers
9387
name: Set up authentication to Google and Google Cloud MCP servers
9488
classification: official
95-
observed_at: "2026-07-29T21:55:51Z"
89+
observed_at: "2026-08-29T15:13:24Z"
9690
- source: provider-documentation
9791
locator: https://cloud.google.com/service-usage/docs/enable-disable
9892
name: Enable and disable services
9993
classification: official
100-
observed_at: "2026-07-29T21:55:51Z"
94+
observed_at: "2026-08-29T15:13:24Z"
10195
- source: provider-documentation
10296
locator: https://docs.cloud.google.com/iam/docs/grant-role-console
10397
name: Grant an IAM role by using the Google Cloud console
10498
classification: official
105-
observed_at: "2026-07-29T21:55:51Z"
99+
observed_at: "2026-08-29T15:13:24Z"
106100
- source: provider-documentation
107101
locator: https://support.google.com/cloud/answer/15549945
108102
name: Manage App Audience
109103
classification: official
110-
observed_at: "2026-07-29T21:55:51Z"
104+
observed_at: "2026-08-29T15:13:24Z"
111105
- source: provider-documentation
112106
locator: https://support.google.com/cloud/answer/15549135
113107
name: Manage App Data Access
114108
classification: official
115-
observed_at: "2026-07-29T21:55:51Z"
109+
observed_at: "2026-08-29T15:13:24Z"
116110
- source: provider-documentation
117111
locator: https://support.google.com/a/answer/7281227
118112
name: Control which apps access Google Workspace data
119113
classification: official
120-
observed_at: "2026-07-29T21:55:51Z"
121-
- source: endpoint-observation
122-
locator: https://people.googleapis.com/mcp/v1
123-
name: Google People API MCP endpoint
124-
classification: official
125-
status: MCP initialize returned HTTP 200
126-
version: "2025-03-26"
127-
observed_at: "2026-07-29T21:55:51Z"
114+
observed_at: "2026-08-29T15:13:24Z"
128115
- source: endpoint-observation
129116
locator: https://people.googleapis.com/.well-known/oauth-protected-resource/mcp/v1
130117
name: Google People API MCP protected-resource metadata
131118
classification: official
132-
observed_at: "2026-07-29T21:55:51Z"
119+
observed_at: "2026-08-29T15:13:24Z"
133120
- source: endpoint-observation
134121
locator: https://accounts.google.com/.well-known/oauth-authorization-server
135122
name: Google authorization-server metadata
136123
classification: official
137-
observed_at: "2026-07-29T21:55:51Z"
124+
observed_at: "2026-08-29T15:13:24Z"
138125
- source: repository-doctrine
139126
locator: doctrine/speakeasy-setup.md
140127
name: Speakeasy setup canonical section
141128
classification: official
142-
observed_at: "2026-07-29T21:55:51Z"
129+
observed_at: "2026-08-29T15:13:24Z"

0 commit comments

Comments
 (0)